Condividi tramite


Liveness Session Operations - Delete Liveness Session

Eliminare tutte le informazioni correlate alla sessione per trovare la corrispondenza con l'ID sessione specificato.

Nota

L'eliminazione di una sessione disattiva il token di autenticazione della sessione bloccando le chiamate API future effettuate con tale token di autenticazione. Anche se questo può essere usato per rimuovere qualsiasi accesso per tale token, tali richieste verranno comunque conteggiate per i limiti complessivi della frequenza delle risorse. È consigliabile sfruttare TokenTTL per limitare la lunghezza dei token nel caso in cui venga usato in modo improprio.

DELETE {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
apiVersion
path True

string

Versione API

endpoint
path True

string

uri

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{nome-risorsa}.cognitiveservices.azure.com).

sessionId
path True

string

ID univoco per fare riferimento a questa sessione.

Risposte

Nome Tipo Descrizione
200 OK

La richiesta ha avuto esito positivo.

Other Status Codes

FaceErrorResponse

Risposta di errore imprevista.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Delete Liveness Session

Esempio di richiesta

DELETE {endpoint}/face/v1.2-preview.1/detectLiveness/singleModal/sessions/b12e033e-bda7-4b83-a211-e721c661f30e

Risposta di esempio

Definizioni

Nome Descrizione
FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome Tipo Descrizione
code

string

Uno di un set definito dal server di codici di errore.

message

string

Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome Tipo Descrizione
error

FaceError

Oggetto error.