Crear sesión de validación visual

Cree una sesión de validación visual antes de cargar materiales liveness_face reutilizables. TokenLab utiliza el formato de la API Action de Volc y la autenticación Bearer de TokenLab.

Use la misma organización autenticada, el mismo usuario y el mismo ProjectName, respetando mayúsculas y minúsculas, que crearon la sesión.

Abra Result.H5Link inmediatamente después de crear la sesión. El plazo del primer acceso H5 puede vencer antes de los 30 minutos de validez de BytedToken.

Endpoint y autenticaciónCopy Anchor Link

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

No se aceptan firmas AK/SK de Volc. CallbackURL es obligatorio y debe ser una URL HTTPS pública. ProjectName es opcional y su valor predeterminado es default.

FlujoCopy Anchor Link

1. Guarde Result.BytedToken y abra Result.H5Link para la persona que se verificará.
2. Para seleccionar el idioma de H5, añada lng a H5Link, por ejemplo &lng=en. El idioma no es un campo del cuerpo de la solicitud.
3. Al finalizar el flujo H5, el navegador abre Result.CallbackURL. La consulta de callback puede contener bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue y verify_type.
4. Consulte Obtener resultado de validación visual con el BytedToken guardado hasta que se devuelva Result.GroupId.

BytedToken es válido durante 30 minutos y está vinculado a la organización autenticada y a ProjectName. El enlace H5 admite una única verificación completada y deja de ser válido después de usarse.

Trate Result.H5Link como una URL de navegador opaca: ábrala como página de nivel superior y no la analice, decodifique, reescriba ni incruste. TokenLab gestiona la entrega al navegador y el puente de callback.

Ejemplo de solicitudCopy 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"}'

Ejemplo de respuestaCopy 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"
  }
}

Los errores utilizan la misma estructura superior. Lea ResponseMetadata.Error.Code y ResponseMetadata.Error.Message en lugar de esperar los campos de error de otras API /v1 de TokenLab.

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

{  "id": "string"}