Person Group Person - Get

Servizio:

Azure AI Services

Versione API:

1.0

Recuperare le informazioni di una persona, inclusi i visi salvati in modo permanente, il nome e userData registrati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
personGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	ID che fa riferimento a un determinato gruppo di persone.
personId	path	True	string (uuid)	ID che fa riferimento a una persona specifica.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Risposte

Nome	Tipo	Descrizione
200 OK	Person	Una chiamata con esito positivo restituisce le informazioni della persona.
Other Status Codes	APIError	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Get person example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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."
}

Definizioni

Nome	Descrizione
APIError	Informazioni sugli errori restituite dall'API
Error	Corpo dell'errore.
Person	Oggetto Person.

APIError

Object

Informazioni sugli errori restituite dall'API

Nome	Tipo	Descrizione
error	Error	Corpo dell'errore.

Error

Object

Corpo dell'errore.

Nome	Tipo	Descrizione
code	string
message	string

Person

Object

Oggetto Person.

Nome	Tipo	Descrizione
name	string maxLength: 128	Il nome definito dall'utente, la lunghezza massima è 128.
persistedFaceIds	string[] (uuid)	PersistedFaceIds di visi registrati nella persona. Questi persistedFaceId vengono restituiti da Person - Add a Person Face e non scadranno.
personId	string (uuid)	PersonId dell'elenco di visi di destinazione.
userData	string maxLength: 16384	Dati specificati dall'utente. La lunghezza non deve superare i 16 KB.