Person Group Person - Get

Service:

Azure AI Services

Version d'API:

1.0

Récupérez les informations d’une personne, y compris les visages persistants enregistrés, le nom et userData.

GET {Endpoint}/face/v1.0/persongroups/{personGroupId}/persons/{personId}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).
personGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	ID référençant un groupe de personnes particulier.
personId	path	True	string (uuid)	ID référençant une personne particulière.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string

Réponses

Nom	Type	Description
200 OK	Person	Un appel réussi retourne les informations de la personne.
Other Status Codes	APIError	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Get person example

Exemple de requête

HTTP

GET {Endpoint}/face/v1.0/persongroups/abc/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Exemple de réponse

Code d’état:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "persistedFaceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ],
  "name": "Ryan",
  "userData": "User-provided data attached to the person."
}

Définitions

Nom	Description
APIError	Informations d’erreur retournées par l’API
Error	Corps de l’erreur.
Person	Objet Person.

APIError

Object

Informations d’erreur retournées par l’API

Nom	Type	Description
error	Error	Corps de l’erreur.

Error

Object

Corps de l’erreur.

Nom	Type	Description
code	string
message	string

Person

Object

Objet Person.

Nom	Type	Description
name	string maxLength: 128	Nom défini par l’utilisateur, la longueur maximale est 128.
persistedFaceIds	string[] (uuid)	PersistedFaceIds des visages inscrits dans la personne. Ces persistedFaceIds sont retournés par Person - Ajouter un visage de personne et n’expireront pas.
personId	string (uuid)	PersonId de la liste des visages cibles.
userData	string maxLength: 16384	Données spécifiées par l’utilisateur. La longueur ne doit pas dépasser 16 Ko.