Person Group Person - Get

Usługa:

Azure AI Services

Wersja interfejsu API:

1.0

Pobierz informacje o danej osobie, w tym zarejestrowane utrwalone twarze, nazwę i nazwę użytkownikaData.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
personGroupId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	Identyfikator odwołujące się do określonej grupy osób.
personId	path	True	string (uuid)	Identyfikator odwołujące się do określonej osoby.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Person	Pomyślne wywołanie zwraca informacje o osobie.
Other Status Codes	APIError	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Get person example

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
APIError	Informacje o błędzie zwrócone przez interfejs API
Error	Treść błędu.
Person	Obiekt osoby.

APIError

Objekt

Informacje o błędzie zwrócone przez interfejs API

Nazwa	Typ	Opis
error	Error	Treść błędu.

Error

Objekt

Treść błędu.

Nazwa	Typ	Opis
code	string
message	string

Person

Objekt

Obiekt osoby.

Nazwa	Typ	Opis
name	string maxLength: 128	Nazwa zdefiniowana przez użytkownika, maksymalna długość to 128.
persistedFaceIds	string[] (uuid)	UtrwaloneFaceId zarejestrowanych twarzy w osobie. Te utrwalone identyfikatoryFaceId są zwracane z kolumny Person — Add a Person Face (Person Face) i nie wygasną.
personId	string (uuid)	PersonId listy twarzy docelowej.
userData	string maxLength: 16384	Dane określone przez użytkownika. Długość nie powinna przekraczać 16 KB.