Liveness Session Operations - Create Liveness With Verify Session With Verify Image
Creare una nuova sessione di liveness con verifica. Specificare l'immagine di verifica durante la creazione della sessione.
Una sessione è ideale per gli scenari dei dispositivi client in cui gli sviluppatori vogliono autorizzare un dispositivo client a eseguire solo un rilevamento di attività senza concedere l'accesso completo alla risorsa. Le sessioni create hanno un periodo di vita limitato e autorizzano i client a eseguire l'azione desiderata prima della scadenza dell'accesso.
Le autorizzazioni includono...
-
- Possibilità di chiamare /detectLivenessWithVerify/singleModal per un massimo di 3 tentativi.
- Durata del token di 10 minuti.
Nota
-
- L'accesso client può essere revocato eliminando la sessione usando l'operazione Delete Liveness With Verify Session .
- Per recuperare un risultato, usare la sessione Get Liveness With Verify.
- Per controllare le singole richieste effettuate da un client alla risorsa, usare le voci List Liveness with Verify Session Audit .
Opzione consigliata: VerifyImage viene fornita durante la creazione della sessione.
POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
Parameters
|
formData | True |
string |
Parametri per la creazione della sessione. |
Verify
|
formData | True |
file |
Flusso di immagini per la verifica. Il campo intestazione Content-Disposition per questa parte deve avere un nome file. |
api
|
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). |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Una chiamata con esito positivo crea una sessione per un dispositivo client e fornisce un token di autorizzazione per l'uso da parte dell'applicazione client per uno scopo e un tempo limitati. |
|
Other Status Codes |
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
Create LivenessWithVerify Session with VerifyImage
Esempio di richiesta
POST {endpoint}/face/v1.2-preview.1/detectLivenessWithVerify/singleModal/sessions
Risposta di esempio
{
"sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
"authToken": "eyJhbGciOiJFUzI1NiIsIm",
"verifyImage": {
"faceRectangle": {
"width": 78,
"height": 78,
"left": 394,
"top": 54
},
"qualityForRecognition": "high"
}
}
Definizioni
Nome | Descrizione |
---|---|
Create |
Risposta della sessione di liveness con verifica della creazione con la verifica dell'immagine fornita. |
Face |
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. |
Face |
Risposta contenente i dettagli dell'errore. |
Face |
Rettangolo all'interno del quale è possibile trovare un viso. |
Liveness |
Dettaglio del viso per la verifica. |
Quality |
Indica la qualità dell'immagine per il riconoscimento. |
CreateLivenessWithVerifySessionResult
Risposta della sessione di liveness con verifica della creazione con la verifica dell'immagine fornita.
Nome | Tipo | Descrizione |
---|---|---|
authToken |
string |
Token di connessione per fornire l'autenticazione per Vision SDK in esecuzione in un'applicazione client. Questo token di connessione dispone di autorizzazioni limitate per eseguire solo l'azione richiesta e scade dopo l'ora TTL. È anche controllabile. |
sessionId |
string |
ID sessione univoco della sessione creata. Scadrà 48 ore dopo la creazione o potrebbe essere eliminato prima usando l'operazione session DELETE corrispondente. |
verifyImage |
Dettaglio del viso per la verifica. |
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 |
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. |
LivenessWithVerifyImage
Dettaglio del viso per la verifica.
Nome | Tipo | Descrizione |
---|---|---|
faceRectangle |
Area del viso in cui è stata effettuata la classificazione dell'immagine di confronto. |
|
qualityForRecognition |
Qualità dell'immagine del viso per il riconoscimento. |
QualityForRecognition
Indica la qualità dell'immagine per il riconoscimento.
Nome | Tipo | Descrizione |
---|---|---|
high |
string |
Alta qualità. |
low |
string |
Bassa qualità. |
medium |
string |
Qualità media. |