Visuelle Verifizierungssitzung erstellen

Erstellen Sie vor dem Hochladen wiederverwendbarer liveness_face-Materialien eine visuelle Verifizierungssitzung. TokenLab verwendet das Format der Volc Action API und die Bearer-Authentifizierung von TokenLab.

Verwenden Sie dieselbe authentifizierte Organisation, denselben Benutzer und denselben, groß-/kleinschreibungssensitiven ProjectName wie beim Erstellen der Sitzung.

Öffnen Sie Result.H5Link direkt nach dem Erstellen der Sitzung. Die Frist für den ersten H5-Aufruf kann früher ablaufen als der 30 Minuten gültige BytedToken.

Endpunkt und AuthentifizierungCopy Anchor Link

POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Volc-AK/SK-Signaturen werden nicht akzeptiert. CallbackURL ist erforderlich und muss eine öffentliche HTTPS-URL sein. ProjectName ist optional und hat den Standardwert default.

AblaufCopy Anchor Link

1. Speichern Sie Result.BytedToken und öffnen Sie Result.H5Link für die zu verifizierende Person.
2. Hängen Sie zur Auswahl der H5-Sprache lng an H5Link an, zum Beispiel &lng=en. Die Sprache ist kein Feld des Anforderungstexts.
3. Nach Abschluss des H5-Ablaufs öffnet der Browser Result.CallbackURL. Die Callback-Abfrage kann bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue und verify_type enthalten.
4. Rufen Sie Visuelles Verifizierungsergebnis abrufen wiederholt mit dem gespeicherten BytedToken auf, bis Result.GroupId zurückgegeben wird.

BytedToken ist 30 Minuten gültig und an die authentifizierte Organisation sowie ProjectName gebunden. Der H5-Link erlaubt eine abgeschlossene Verifizierung und wird danach ungültig.

Behandeln Sie Result.H5Link als undurchsichtige Browser-URL: Öffnen Sie sie als Seite der obersten Ebene und analysieren, decodieren, verändern oder betten Sie sie nicht ein. TokenLab verwaltet die Browser-Weiterleitung und die Callback-Brücke.

BeispielanfrageCopy Anchor Link

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

BeispielantwortCopy Anchor Link

{
  "ResponseMetadata": {
    "RequestId": "req_abc123",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "ZXhhbXBsZS10b2tlbg",
    "H5Link": "https://api.tokenlab.sh/api/v3/visual-validation/sessions/svv_example/h5?Version=2024-01-01",
    "CallbackURL": "https://yourapp.example.com/seedance/callback"
  }
}

Fehler verwenden dieselbe oberste Struktur. Lesen Sie ResponseMetadata.Error.Code und ResponseMetadata.Error.Message statt der Fehlerfelder anderer TokenLab-/v1-APIs.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}