Partager via

Liveness Session Operations - Create Liveness With Verify Session With Verify Image

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Créez une session liveness avec vérification. Fournissez l’image de vérification pendant la création de la session.
Une session est idéale pour les scénarios d’appareil client dans lesquels les développeurs souhaitent autoriser un appareil client à effectuer uniquement une détection d’liveness sans accorder un accès total à leur ressource. Les sessions créées ont une durée de vie limitée et autorisent uniquement les clients à effectuer l’action souhaitée avant l’expiration de l’accès.

Les autorisations incluent...

    • Possibilité d’appeler /detectLivenessWithVerify/singleModal jusqu’à 3 nouvelles tentatives.
    • Durée de vie du jeton de 10 minutes.

Note

    • L’accès client peut être révoqué en supprimant la session à l’aide de l’opération Delete Liveness With Verify Session.
    • Pour récupérer un résultat, utilisez la session Get Liveness With Verify.
    • Pour auditer les demandes individuelles qu’un client a adressées à votre ressource, utilisez la liste dynamique avec les entrées d’audit de session de vérification.

Option recommandée : VerifyImage est fourni lors de la création de session.

POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions

Paramètres URI

Nom Dans Obligatoire Type Description
Parameters
 formData True

string

Paramètres de création de session.
VerifyImage
 formData True

file

Flux d’images à vérifier. Le champ d’en-tête Content-Disposition de cette partie doit avoir un nom de fichier.
apiVersion
 path True

string

Version de l’API
endpoint
 path True

string

uri

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).

Réponses

Nom Type Description
200 OK

CreateLivenessWithVerifySessionResult

Un appel réussi crée une session pour un appareil client et fournit un jeton d’autorisation à utiliser par l’application cliente à des fins limitées et à temps.
Other Status Codes

FaceErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

Nom Description
https://cognitiveservices.azure.com/.default

Exemples

Create LivenessWithVerify Session with VerifyImage

Exemple de requête

POST {endpoint}/face/v1.2-preview.1/detectLivenessWithVerify/singleModal/sessions

Exemple de réponse

Code d’état:
200 
{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "verifyImage": {
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "qualityForRecognition": "high"
  }
}

Définitions

Nom Description
CreateLivenessWithVerifySessionResult

Réponse de la session liveness avec la création de vérification avec la vérification de l’image fournie.
FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Réponse contenant les détails de l’erreur.
FaceRectangle

Rectangle dans lequel un visage peut être trouvé.
LivenessWithVerifyImage

Détail du visage pour la vérification.
QualityForRecognition

Indique la qualité de l’image pour la reconnaissance.

CreateLivenessWithVerifySessionResult

Réponse de la session liveness avec la création de vérification avec la vérification de l’image fournie.

Nom Type Description
authToken

string

Jeton du porteur pour fournir l’authentification pour le Kit de développement logiciel (SDK) Vision s’exécutant sur une application cliente. Ce jeton du porteur dispose d’autorisations limitées pour effectuer uniquement l’action requise et expire après la durée de vie. Il est également auditable.
sessionId

string

ID de session unique de la session créée. Il expire 48 heures après sa création ou peut être supprimé plus tôt à l’aide de l’opération de suppression de session correspondante.
verifyImage

LivenessWithVerifyImage

Détail du visage pour la vérification.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom Type Description
code

string

Un ensemble de codes d’erreur définis par le serveur.
message

string

Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom Type Description
error

FaceError

Objet d’erreur.

FaceRectangle

Rectangle dans lequel un visage peut être trouvé.

Nom Type Description
height

integer

Hauteur du rectangle, en pixels.
left

integer

Distance du bord gauche si l’image au bord gauche du rectangle, en pixels.
top

integer

Distance du bord supérieur si l’image au bord supérieur du rectangle, en pixels.
width

integer

Largeur du rectangle, en pixels.

LivenessWithVerifyImage

Détail du visage pour la vérification.

Nom Type Description
faceRectangle

FaceRectangle

Région de visage où la classification de l’image de comparaison a été effectuée.
qualityForRecognition

QualityForRecognition

Qualité de l’image faciale pour la reconnaissance.

QualityForRecognition

Indique la qualité de l’image pour la reconnaissance.

Nom Type Description
high

string

Haute qualité.
low

string

Qualité faible.
medium

string

Qualité moyenne.