Vídeo e materiais

Obter Resultado de Validação Visual

Obtém o grupo de material de pessoa real produzido pela validação visual.

POST
/api/v3

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

Envie 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.

StatusCódigoCausa
400InvalidParameterBytedToken é inválido ou expirou, ProjectName não corresponde ou a verificação ainda não foi concluída (tente novamente)
400InvalidVersionVersion não é 2024-01-01
405MethodNotAllowedA Action aceita apenas POST
409ConflictO grupo verificado já está mapeado para outra organização
503ServiceUnavailableA 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
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: 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
padrão"2024-01-01"

Cabeçalhos

X-TokenLab-Delivery-Policy?string

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