Liveness Session Operations - Get Liveness Session Audit Entries
Hämtar sessionsbegäranden och svarstext för sessionen.
GET {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}/audit
GET {endpoint}/face/{apiVersion}/detectLiveness/singleModal/sessions/{sessionId}/audit?start={start}&top={top}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-version |
endpoint
|
path | True |
string uri |
Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com). |
session
|
path | True |
string |
Det unika ID som ska referera till den här sessionen. |
start
|
query |
string |
Visa en lista över resurser som är större än "start". Den innehåller högst 64 tecken. Standardvärdet är tomt. |
|
top
|
query |
integer int32 |
Antalet objekt att lista, i [1, 1000]. Standardvärdet är 1 000. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Begäran har slutförts. |
|
Other Status Codes |
Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string |
Säkerhet
Ocp-Apim-Subscription-Key
Den hemliga nyckeln för din Ansiktsprenumeration på Azure AI.
Typ:
apiKey
I:
header
AADToken
Azure Active Directory OAuth2-flödet
Typ:
oauth2
Flow:
accessCode
Auktoriseringswebbadress:
https://api.example.com/oauth2/authorize
Token-webbadress:
https://api.example.com/oauth2/token
Omfattningar
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Exempel
Get LivenessSession Audit Entries
Exempelbegäran
GET {endpoint}/face/v1.1-preview.1/detectLiveness/singleModal/sessions/b12e033e-bda7-4b83-a211-e721c661f30e/audit?start=0&top=20
Exempelsvar
[
{
"id": 4,
"sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
"requestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
"clientRequestId": "4af681e9-0e25-43e9-9922-a7adebf13b2f",
"receivedDateTime": "2024-03-05T11:07:29.698Z",
"request": {
"url": "/face/v1.1-preview.1/detectliveness/singlemodal",
"method": "POST",
"contentLength": 18,
"contentType": "multipart/form-data",
"userAgent": "Mozilla/5.0 (Linux) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/117.0.0.0 Mobile Safari/537.36"
},
"response": {
"body": {},
"statusCode": 200,
"latencyInMilliseconds": 1200
},
"digest": "1CC98BA83EAF1D0FF7F566FAEFCCCC787819FFA01251E2D9299143F7AD6651DB"
}
]
Definitioner
Name | Description |
---|---|
Audit |
Granskningspost för ett svar i sessionen. |
Audit |
Granskningspost för en begäran i sessionen. |
Face |
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages. |
Face |
Ett svar som innehåller felinformation. |
Face |
En rektangel där ett ansikte kan hittas. |
Image |
Typ av bild. |
Liveness |
Resultatet av livenessklassificeringen. |
Liveness |
Den modellversion som används för liveness-klassificering. |
Liveness |
Liveness-klassificeringen för mål ansikte. |
Liveness |
Svarstexten för API-anropet detect liveness. |
Liveness |
Granskningspost för en begäran i sessionen. |
Liveness |
Detaljerna i ansiktet för verifiering. |
Liveness |
Ansiktsverifieringens utdata. |
Quality |
Anger bildkvalitet för igenkänning. |
AuditLivenessResponseInfo
Granskningspost för ett svar i sessionen.
Name | Typ | Description |
---|---|---|
body |
Svarstexten. Schemat för det här fältet beror på vilken request.url och request.method som används av klienten. |
|
latencyInMilliseconds |
integer |
Servern mätte svarstiden för den här begäran i millisekunder. |
statusCode |
integer |
HTTP-statuskoden returnerades till klienten. |
AuditRequestInfo
Granskningspost för en begäran i sessionen.
Name | Typ | Description |
---|---|---|
contentLength |
integer |
Längden på begärandetexten i byte. |
contentType |
string |
Innehållstypen för begäran. |
method |
string |
HTTP-metoden för begäran (t.ex. GET, POST, DELETE). |
url |
string |
Den relativa URL:en och frågan för liveness-begäran. |
userAgent |
string |
Användaragenten som används för att skicka begäran. |
FaceError
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Description |
---|---|---|
code |
string |
En av en serverdefinierad uppsättning felkoder. |
message |
string |
En mänsklig läsbar representation av felet. |
FaceErrorResponse
Ett svar som innehåller felinformation.
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
FaceRectangle
En rektangel där ett ansikte kan hittas.
Name | Typ | Description |
---|---|---|
height |
integer |
Rektangelns höjd i bildpunkter. |
left |
integer |
Avståndet från vänsterkanten om bilden till vänsterkanten i rektangeln, i bildpunkter. |
top |
integer |
Avståndet från den övre kanten om bilden till rektangelns övre kant, i bildpunkter. |
width |
integer |
Rektangelns bredd i bildpunkter. |
ImageType
Typ av bild.
Name | Typ | Description |
---|---|---|
Color |
string |
Färgbild. |
Depth |
string |
Djupbild. |
Infrared |
string |
Infraröd bild. |
LivenessDecision
Resultatet av livenessklassificeringen.
Name | Typ | Description |
---|---|---|
realface |
string |
Algoritmen har klassificerat måligenkänningen som verklig. |
spoofface |
string |
Algoritmen har klassificerat mål ansikte som en förfalskning. |
uncertain |
string |
Algoritmen kunde inte klassificera mål ansikte som antingen verkliga eller falska. |
LivenessModel
Den modellversion som används för liveness-klassificering.
Name | Typ | Description |
---|---|---|
2022-10-15-preview.04 |
string |
|
2023-12-20-preview.06 |
string |
LivenessOutputsTarget
Liveness-klassificeringen för mål ansikte.
Name | Typ | Description |
---|---|---|
faceRectangle |
Ansiktsregionen där livenessklassificeringen gjordes. |
|
fileName |
string |
Filnamnet som innehåller ansiktsrektangeln där liveness-klassificeringen gjordes. |
imageType |
Bildtypen som innehåller ansiktsrektangeln där livenessklassificeringen gjordes. |
|
timeOffsetWithinFile |
integer |
Tidsförskjutningen i filen i ramen som innehåller ansiktsrektangeln där livenessklassificeringen gjordes. |
LivenessResponseBody
Svarstexten för API-anropet detect liveness.
Name | Typ | Description |
---|---|---|
livenessDecision |
Liveness-klassificeringen för målinsiktet. |
|
modelVersionUsed |
Den modellversion som används för liveness-klassificering. |
|
target |
Specifika mål som används för liveness-klassificering. |
|
verifyResult |
Ansiktsverifieringens utdata. Endast tillgängligt när begäran är liveness med verifiering. |
LivenessSessionAuditEntry
Granskningspost för en begäran i sessionen.
Name | Typ | Description |
---|---|---|
clientRequestId |
string |
Det unika clientRequestId som skickas av klienten i rubriken "client-request-id". |
digest |
string |
Servern beräknade sammandrag för den här begäran. Om klientens rapporterade sammandrag skiljer sig från serverns beräknade sammandrag har meddelandeintegriteten mellan klienten och tjänsten komprometterats och resultatet bör inte vara betrott. Mer information finns i guider om hur du använder det här värdet för att skydda din slutpunkt till slutpunkt-lösning. |
id |
integer |
Det unika ID:t som refererar till den här granskningsbegäran. Använd det här ID:t med frågeparametern "start" för att fortsätta till nästa sida med granskningsresultat. |
receivedDateTime |
string |
UTC DateTime som begäran togs emot. |
request |
Begäran om den här posten. |
|
requestId |
string |
Det unika requestId som returneras av tjänsten till klienten i rubriken "apim-request-id". |
response |
Svaret för den här posten. |
|
sessionId |
string |
Det unika sessions-ID:et för den skapade sessionen. Den upphör att gälla 48 timmar efter att den har skapats eller kan tas bort tidigare med hjälp av motsvarande session DELETE-åtgärd. |
LivenessWithVerifyImage
Detaljerna i ansiktet för verifiering.
Name | Typ | Description |
---|---|---|
faceRectangle |
Ansiktsregionen där jämförelsebildens klassificering gjordes. |
|
qualityForRecognition |
Kvaliteten på ansiktsbilden för igenkänning. |
LivenessWithVerifyOutputs
Ansiktsverifieringens utdata.
Name | Typ | Description |
---|---|---|
isIdentical |
boolean |
Om målets liveness ansikte och jämförelse bild ansiktsmatchning. |
matchConfidence |
number |
Mål ansikte liveness ansikte och jämförelse bild ansikte verifiering konfidens. |
verifyImage |
Detaljerna i ansiktet för verifiering. |
QualityForRecognition
Anger bildkvalitet för igenkänning.
Name | Typ | Description |
---|---|---|
high |
string |
Hög kvalitet. |
low |
string |
Låg kvalitet. |
medium |
string |
Medelhög kvalitet. |