Vídeo e materiais
Obter Resultado de Validação Visual
Obtém o grupo de material de pessoa real produzido pela validação visual.
Consulte esta Action após o fluxo de validação visual H5. Um resultado bem-sucedido retorna o ID do grupo de material TokenLab para a pessoa verificada.
Use a mesma organização autenticada, usuário e ProjectName (diferencia maiúsculas de minúsculas) que criou a sessão.
Endpoint e Autenticação
POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonEnvie o BytedToken retornado por Criar Sessão de Validação Visual. Se você definiu ProjectName durante a criação, envie o mesmo valor (diferenciando maiúsculas de minúsculas) aqui; caso contrário, omita-o ou use default.
O resultado pode não estar pronto imediatamente após o callback do navegador. Tente novamente a mesma requisição até que Result.GroupId seja retornado ou o BytedToken de 30 minutos expire. Repetir uma requisição bem-sucedida com o mesmo token retorna o mesmo GroupId mapeado.
Use o GroupId retornado como o group_id ao criar ativos de material liveness_face.
Exemplo de Requisição
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"}'Exemplo de Resposta
{
"ResponseMetadata": {
"RequestId": "req_def456",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"GroupId": "group-20260720123456-real1"
}
}Os erros utilizam ResponseMetadata.Error.Code e ResponseMetadata.Error.Message. Uma resposta de sucesso contém ResponseMetadata e Result; ela não utiliza o envelope de resposta de outras APIs /v1 do TokenLab.
| Status | Código | Causa |
|---|---|---|
400 | InvalidParameter | BytedToken é inválido ou expirou, ProjectName não corresponde ou a verificação ainda não foi concluída (tente novamente) |
400 | InvalidVersion | Version não é 2024-01-01 |
405 | MethodNotAllowed | A Action aceita apenas POST |
409 | Conflict | O grupo verificado já está mapeado para outra organização |
503 | ServiceUnavailable | A validação de pessoa real está indisponível ou a requisição falhou; tente novamente mais tarde |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: 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"Cabeçalhos
Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.
Valores permitidos
- "auto"
- "verified"
- "official"
Corpo da requisição
application/json
Resposta
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json