Video & Materialien

Ergebnis der visuellen Validierung abrufen

Ruft die durch die visuelle Validierung erzeugte Materialgruppe für echte Personen ab.

POST
/api/v3

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/json

Senden 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.

StatusCodeUrsache
400InvalidParameterBytedToken ist ungültig oder abgelaufen, ProjectName stimmt nicht überein oder die Verifizierung ist noch nicht abgeschlossen (erneut versuchen)
400InvalidVersionVersion ist nicht 2024-01-01
405MethodNotAllowedDie Action akzeptiert nur POST
409ConflictDie verifizierte Gruppe ist bereits einer anderen Organisation zugeordnet
503ServiceUnavailableDie 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
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Abfrageparameter

Action?string

Zulässige Werte

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
Standard"2024-01-01"

Header

X-TokenLab-Delivery-Policy?string

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