Liveness Session Operations - Get Liveness Session Result

Riferimento

Servizio:: Azure AI Services

Versione API:: v1.2-preview.1

Ottiene il risultato della sessione di detectLiveness/singleModal.

GET {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	LivenessSession	La richiesta ha avuto esito positivo.
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

LivenessSession

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

Get LivenessSession Result

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "id": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "createdDateTime": "2024-03-05T11:07:29.698Z",
  "sessionStartDateTime": "2024-03-05T11:07:29.698Z",
  "sessionExpired": true,
  "deviceCorrelationId": "your_device_correlation_id",
  "authTokenTimeToLiveInSeconds": 600,
  "status": "NotStarted",
  "result": {
    "id": 4,
    "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
    "requestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
    "clientRequestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
    "receivedDateTime": "2024-03-05T11:07:29.698Z",
    "request": {
      "url": "/face/v1.2-preview.1/detectliveness/singlemodal",
      "method": "POST",
      "contentLength": 18,
      "contentType": "multipart/form-data",
      "userAgent": "Mozilla/5.0 (Linux) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
    },
    "response": {
      "body": {},
      "statusCode": 200,
      "latencyInMilliseconds": 1200
    },
    "digest": "1CC98BA83EAF1D0FF7F566FAEFCCCC787819FFA01251E2D9299143F7AD6651DB"
  }
}

Definizioni

Nome	Descrizione
AuditLivenessResponseInfo	Voce di controllo per una risposta nella sessione.
AuditRequestInfo	Voce di controllo per una richiesta nella sessione.
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.
FaceRectangle	Rettangolo all'interno del quale è possibile trovare un viso.
FaceSessionStatus	Stato corrente della sessione.
ImageType	Tipo di immagine.
LivenessDecision	Risultato della classificazione del liveness.
LivenessModel	Versione del modello usata per la classificazione del liveness.
LivenessOutputsTarget	Classificazione del liveness per il viso di destinazione.
LivenessResponseBody	Corpo della risposta della chiamata API di rilevamento dell'attività.
LivenessSession	Risultato della sessione di rilevamento dell'attività.
LivenessSessionAuditEntry	Voce di controllo per una richiesta nella sessione.
LivenessWithVerifyImage	Dettaglio del viso per la verifica.
LivenessWithVerifyOutputs	Output di verifica del viso.
QualityForRecognition	Indica la qualità dell'immagine per il riconoscimento.

AuditLivenessResponseInfo

Voce di controllo per una risposta nella sessione.

Nome	Tipo	Descrizione
body	LivenessResponseBody	Corpo della risposta. Lo schema di questo campo dipenderà dal file request.url e request.method usato dal client.
latencyInMilliseconds	integer	La latenza misurata dal server per questa richiesta in millisecondi.
statusCode	integer	Codice di stato HTTP restituito al client.

AuditRequestInfo

Voce di controllo per una richiesta nella sessione.

Nome	Tipo	Descrizione
contentLength	integer	Lunghezza del corpo della richiesta in byte.
contentType	string	Tipo di contenuto della richiesta.
method	string	Metodo HTTP della richiesta (ad esempio, GET, POST, DELETE).
url	string	URL relativo e query della richiesta di attività.
userAgent	string	Agente utente usato per inviare la richiesta.

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.

FaceRectangle

Rettangolo all'interno del quale è possibile trovare un viso.

Nome	Tipo	Descrizione
height	integer	Altezza del rettangolo, in pixel.
left	integer	Distanza dal bordo sinistro se l'immagine al bordo sinistro del rettangolo, in pixel.
top	integer	Distanza dal bordo superiore se l'immagine al bordo superiore del rettangolo, in pixel.
width	integer	Larghezza del rettangolo, in pixel.

FaceSessionStatus

Stato corrente della sessione.

Nome	Tipo	Descrizione
NotStarted	string	La sessione non è stata avviata.
ResultAvailable	string	Il risultato della sessione è disponibile.
Started	string	Sessione avviata.

ImageType

Tipo di immagine.

Nome	Tipo	Descrizione
Color	string	Immagine a colori.
Depth	string	Immagine di profondità.
Infrared	string	Immagine a infrarossi.

LivenessDecision

Risultato della classificazione del liveness.

Nome	Tipo	Descrizione
realface	string	L'algoritmo ha classificato il viso di destinazione come reale.
spoofface	string	L'algoritmo ha classificato il viso di destinazione come uno spoofing.
uncertain	string	L'algoritmo non è riuscito a classificare il viso di destinazione come reale o spoofing.

LivenessModel

Versione del modello usata per la classificazione del liveness.

Nome	Tipo	Descrizione
2022-10-15-preview.04	string
2023-12-20-preview.06	string

LivenessOutputsTarget

Classificazione del liveness per il viso di destinazione.

Nome	Tipo	Descrizione
faceRectangle	FaceRectangle	Area del viso in cui è stata effettuata la classificazione del livello di attività.
fileName	string	Nome del file che contiene il rettangolo del viso in cui è stata eseguita la classificazione dell'attività.
imageType	ImageType	Tipo di immagine che contiene il rettangolo del viso in cui è stata eseguita la classificazione della dinamica.
timeOffsetWithinFile	integer	Offset temporale all'interno del file del frame che contiene il rettangolo del viso in cui è stata eseguita la classificazione della durata.

LivenessResponseBody

Corpo della risposta della chiamata API di rilevamento dell'attività.

Nome	Tipo	Descrizione
livenessDecision	LivenessDecision	Classificazione del liveness per il viso di destinazione.
modelVersionUsed	LivenessModel	Versione del modello usata per la classificazione del liveness.
target	LivenessOutputsTarget	Destinazioni specifiche usate per la classificazione del liveness.
verifyResult	LivenessWithVerifyOutputs	Output di verifica del viso. Disponibile solo quando la richiesta è attiva con la verifica.