Person Directory Operations - Get Person Faces

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Haal de persistenteFaceIds van een persoon op die de gezichtsfunctie(s) van de geregistreerde persoon vertegenwoordigen.

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

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).
personId	path	True	string uuid	Persoons-id van de persoon.
recognitionModel	path	True	RecognitionModel	Het 'recognitionModel' dat is gekoppeld aan gezichten.

Antwoorden

Name	Type	Description
200 OK	ListFaceResult	Een geslaagde aanroep retourneert een matrix van persistenteFaceIds en een persoons-id.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Get Faces from PersonDirectory Person

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
ListFaceResult	Antwoord van lijst gezicht van persoon.
RecognitionModel	Het herkenningsmodel voor het gezicht.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

ListFaceResult

Antwoord van lijst gezicht van persoon.

Name	Type	Description
persistedFaceIds	string[]	Matrix van persistente gezichts-id's.
personId	string	Id van persoon.

RecognitionModel

Het herkenningsmodel voor het gezicht.

Name	Type	Description
recognition_01	string	Het standaardherkenningsmodel voor 'Detecteren'. Al deze faceIds die vóór 2019 maart zijn gemaakt, worden gekoppeld aan dit herkenningsmodel.
recognition_02	string	Het herkenningsmodel is uitgebracht in maart 2019.
recognition_03	string	Het herkenningsmodel is uitgebracht in 2020.
recognition_04	string	Het herkenningsmodel is uitgebracht in 2021 februari. Het is raadzaam om dit herkenningsmodel te gebruiken voor betere nauwkeurigheid van herkenning.