Video y recursos

Obtener resultado de validación visual

Obtiene el grupo de material de persona real producido por la validación visual.

POST
/api/v3

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

Enví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.

EstadoCódigoCausa
400InvalidParameterBytedToken es inválido o ha expirado, ProjectName no coincide, o la verificación aún no se ha completado (reintente)
400InvalidVersionVersion no es 2024-01-01
405MethodNotAllowedLa Action solo acepta POST
409ConflictEl grupo verificado ya está asignado a otra organización
503ServiceUnavailableLa 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
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de consulta

Action?string

Valores permitidos

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

Encabezados

X-TokenLab-Delivery-Policy?string

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