Video y recursos
Obtener resultado de validación visual
Obtiene el grupo de material de persona real producido por la validación visual.
Realice un sondeo (poll) de esta Action después del flujo de validación visual H5. Un resultado exitoso devuelve el ID de grupo de material de TokenLab para la persona verificada.
Utilice la misma organización autenticada, el mismo usuario y el mismo ProjectName (sensible a mayúsculas y minúsculas) que creó la sesión.
Endpoint y autenticación
POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonEnvíe el BytedToken devuelto por Crear sesión de validación visual. Si estableció ProjectName durante la creación, envíe el mismo valor sensible a mayúsculas y minúsculas aquí; de lo contrario, omítalo o utilice default.
Es posible que el resultado no esté listo inmediatamente después de la devolución de llamada (callback) del navegador. Reintente la misma solicitud hasta que se devuelva Result.GroupId o hasta que expire el BytedToken de 30 minutos. Repetir una solicitud exitosa con el mismo token devuelve el mismo GroupId asignado.
Utilice el GroupId devuelto como group_id al crear activos de material liveness_face.
Ejemplo de solicitud
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"}'Ejemplo de respuesta
{
"ResponseMetadata": {
"RequestId": "req_def456",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"GroupId": "group-20260720123456-real1"
}
}Los errores utilizan ResponseMetadata.Error.Code y ResponseMetadata.Error.Message. Una respuesta exitosa contiene ResponseMetadata y Result; no utiliza el sobre de respuesta de otras APIs /v1 de TokenLab.
| Estado | Código | Causa |
|---|---|---|
400 | InvalidParameter | BytedToken es inválido o ha expirado, ProjectName no coincide, o la verificación aún no se ha completado (reintente) |
400 | InvalidVersion | Version no es 2024-01-01 |
405 | MethodNotAllowed | La Action solo acepta POST |
409 | Conflict | El grupo verificado ya está asignado a otra organización |
503 | ServiceUnavailable | La validación de persona real no está disponible o la solicitud falló; reintente más tarde |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de consulta
Valores permitidos
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json