Video & Materialien
Ergebnis der visuellen Validierung abrufen
Ruft die durch die visuelle Validierung erzeugte Materialgruppe für echte Personen ab.
Fragen Sie diese Action nach dem H5-Ablauf der visuellen Validierung ab. Ein erfolgreiches Ergebnis liefert die TokenLab-Materialgruppen-ID für die verifizierte Person.
Verwenden Sie dieselbe authentifizierte Organisation, denselben Benutzer und denselben groß-/kleinschreibungssensitiven ProjectName, die auch die Sitzung erstellt haben.
Endpunkt und Authentifizierung
POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonSenden Sie das BytedToken, das von Visuelle Validierungssitzung erstellen zurückgegeben wurde. Wenn Sie während der Erstellung einen ProjectName festgelegt haben, senden Sie hier denselben groß-/kleinschreibungssensitiven Wert; andernfalls lassen Sie ihn weg oder verwenden Sie default.
Das Ergebnis ist möglicherweise nicht sofort nach dem Browser-Callback verfügbar. Wiederholen Sie dieselbe Anfrage, bis Result.GroupId zurückgegeben wird oder das 30-minütige BytedToken abläuft. Das Wiederholen einer erfolgreichen Anfrage mit demselben Token liefert dieselbe zugeordnete GroupId.
Verwenden Sie die zurückgegebene GroupId als group_id beim Erstellen von liveness_face Material-Assets.
Beispielanfrage
curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'Beispielantwort
{
"ResponseMetadata": {
"RequestId": "req_def456",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"GroupId": "group-20260720123456-real1"
}
}Fehler verwenden ResponseMetadata.Error.Code und ResponseMetadata.Error.Message. Eine Erfolgsantwort enthält ResponseMetadata und Result; sie verwendet nicht den Antwort-Envelope der anderen /v1 APIs von TokenLab.
| Status | Code | Ursache |
|---|---|---|
400 | InvalidParameter | BytedToken ist ungültig oder abgelaufen, ProjectName stimmt nicht überein oder die Verifizierung ist noch nicht abgeschlossen (erneut versuchen) |
400 | InvalidVersion | Version ist nicht 2024-01-01 |
405 | MethodNotAllowed | Die Action akzeptiert nur POST |
409 | Conflict | Die verifizierte Gruppe ist bereits einer anderen Organisation zugeordnet |
503 | ServiceUnavailable | Die Validierung echter Personen ist nicht verfügbar oder die Anfrage ist fehlgeschlagen; versuchen Sie es später erneut |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Abfrageparameter
Zulässige Werte
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.
Zulässige Werte
- "auto"
- "verified"
- "official"
Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json