Condividi tramite


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.

VerifyImage
formData True

file

Flusso di immagini per la verifica. Il campo intestazione Content-Disposition per questa parte deve avere un nome file.

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).

Risposte

Nome Tipo Descrizione
200 OK

CreateLivenessWithVerifySessionResult

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

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

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
CreateLivenessWithVerifySessionResult

Risposta della sessione di liveness con verifica della creazione con la verifica dell'immagine fornita.

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.

LivenessWithVerifyImage

Dettaglio del viso per la verifica.

QualityForRecognition

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

LivenessWithVerifyImage

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

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.

LivenessWithVerifyImage

Dettaglio del viso per la verifica.

Nome Tipo Descrizione
faceRectangle

FaceRectangle

Area del viso in cui è stata effettuata la classificazione dell'immagine di confronto.

qualityForRecognition

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.