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

Service:

Azure AI Services

Version d'API:

v1.1-preview.1

Create une nouvelle session liveness avec verify. Fournissez l’image de vérification lors de la création de la session.
Une session est idéale pour les scénarios d’appareil client où les développeurs souhaitent autoriser un appareil client à effectuer uniquement une détection d’ergonomie 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 pour un maximum de 3 nouvelles tentatives.
  • Durée de vie du jeton de 10 minutes.

Notes

• • L’accès client peut être révoqué en supprimant la session à l’aide de l’opération Supprimer 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 Liveness With Verify Session Audit Entrées.

Option recommandée : VerifyImage est fourni lors de la création de la 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 pour cette partie doit avoir un nom de fichier.
apiVersion	path	True	string	Version d'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 pour une utilisation par l’application cliente à un usage et dans un temps limités.
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

HTTP

POST {endpoint}/face/v1.1-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 vérifier la création avec l’image de vérification 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 vérifier la création avec l’image de vérification fournie.

Nom	Type	Description
authToken	string	Jeton du porteur pour fournir l’authentification pour le Kit de développement logiciel (SDK) Vision exécuté 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 vérifiable.
sessionId	string	ID de session unique de la session créée. Il expirera 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 des 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 se trouve sur le bord gauche du rectangle, en pixels.
top	integer	Distance entre le bord supérieur si l’image et le 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 du visage où la classification de l’image de comparaison a été effectuée.
qualityForRecognition	QualityForRecognition	Qualité de l’image du visage pour la reconnaissance.

QualityForRecognition

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

Nom	Type	Description
high	string	Qualité élevée.
low	string	Qualité médiocre.
medium	string	Qualité moyenne.