Person Group Operations - Get Person Group Person

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Načtěte jméno a uživatelská data osoby a trvalé id faceId představující funkce rozpoznávání tváře registrované osoby.

GET {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID kontejneru. Vzor regulárního výrazu: ^[a-z0-9-_]+$
personId	path	True	string uuid	ID osoby.

Odpovědi

Name	Typ	Description
200 OK	PersonGroupPerson	Úspěšné volání vrátí informace o osobě.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

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

Příklady

Get Person from PersonGroup

Ukázkový požadavek

HTTP

GET {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1

Ukázková odpověď

Stavový kód:

200

{
  "personId": "25985303-c537-4467-b41d-bdb45cd95ca1",
  "name": "your_person_group_person_name",
  "userData": "your_user_data",
  "persistedFaceIds": [
    "43897a75-8d6f-42cf-885e-74832febb055"
  ]
}

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
PersonGroupPerson	Osoba v zadané skupině osob. Pokud chcete k této osobě přidat tvář, zavolejte "Přidat tvář osoby velké skupiny osob".

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

PersonGroupPerson

Osoba v zadané skupině osob. Pokud chcete k této osobě přidat tvář, zavolejte "Přidat tvář osoby velké skupiny osob".

Name	Typ	Description
name	string	Uživatelem definované jméno, maximální délka je 128.
persistedFaceIds	string[]	ID obličeje registrovaných tváří v dané osobě.
personId	string	ID osoby.
userData	string	Volitelná uživatelsky definovaná data Délka by neměla překročit 16 tisíc.