Person Directory Operations - Get Person Faces

Szolgáltatás:: Azure AI Services

API-verzió:: v1.2-preview.1

Lekérheti a regisztrált személy arcvonásait képviselő tartósFaceId-azonosítókat.

GET {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string (uri)	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).
personId	path	True	string (uuid)	A személy azonosítója.
recognitionModel	path	True	RecognitionModel	Az arcokhoz társított "recognitionModel".

Válaszok

Name	Típus	Description
200 OK	ListFaceResult	A sikeres hívás a tartósFaceIds tömböt és egy személyazonosítót ad vissza.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Name

Típus

Description

200 OK

ListFaceResult

A sikeres hívás a tartósFaceIds tömböt és egy személyazonosítót ad vissza.

Other Status Codes

FaceErrorResponse

Váratlan hibaválasz.

Fejlécek

x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Típus: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://api.example.com/oauth2/authorize
Jogkivonat URL-címe: https://api.example.com/oauth2/token

Hatókörök

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

Példák

Get Faces from PersonDirectory Person

Mintakérelem

HTTP

GET {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces

Mintaválasz

Állapotkód:: 200

{
  "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
  "persistedFaceIds": [
    "43897a75-8d6f-42cf-885e-74832febb055"
  ]
}

Definíciók

Name	Description
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hibaadatokat tartalmazó válasz.
ListFaceResult	A személylista arcának válasza.
RecognitionModel	Az arc felismerési modellje.

FaceError

Objektum

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba ember által olvasható ábrázolása.

FaceErrorResponse

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

ListFaceResult

Objektum

A személylista arcának válasza.

Name	Típus	Description
persistedFaceIds	string[] (uuid)	A megőrzött arcazonosítók tömbje.
personId	string (uuid)	Személy azonosítója.

RecognitionModel

Enumerálás

Az arc felismerési modellje.

Érték	Description
recognition_01	Az "Detect" alapértelmezett felismerési modellje. A 2019 márciusa előtt létrehozott faceId-eket ez a felismerési modell köti össze.
recognition_02	A 2019. márciusban kiadott felismerési modell.
recognition_03	Az elismerési modell 2020 májusában jelent meg.
recognition_04	A 2021 februárjában kiadott felismerési modell. Javasoljuk, hogy ezt a felismerési modellt használja a jobb felismerési pontosság érdekében.