Criar sessão de validação visual

Crie uma sessão de validação visual antes de enviar materiais liveness_face reutilizáveis. O TokenLab usa o formato da API Action da Volc e a autenticação Bearer do TokenLab.

Use a mesma organização autenticada, o mesmo usuário e o mesmo ProjectName, diferenciando maiúsculas e minúsculas, usados na criação da sessão.

Abra Result.H5Link imediatamente após criar a sessão. O prazo do primeiro acesso H5 pode expirar antes dos 30 minutos de validade de BytedToken.

Endpoint e autenticaçãoCopy Anchor Link

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

Assinaturas AK/SK da Volc não são aceitas. CallbackURL é obrigatório e deve ser uma URL HTTPS pública. ProjectName é opcional e o padrão é default.

FluxoCopy Anchor Link

1. Salve Result.BytedToken e abra Result.H5Link para a pessoa que será verificada.
2. Para escolher o idioma do H5, acrescente lng a H5Link, por exemplo &lng=en. O idioma não é um campo do corpo da requisição.
3. Quando o fluxo H5 terminar, o navegador abrirá Result.CallbackURL. A consulta de callback pode conter bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue e verify_type.
4. Consulte Obter resultado da validação visual com o BytedToken salvo até que Result.GroupId seja retornado.

BytedToken é válido por 30 minutos e fica vinculado à organização autenticada e ao ProjectName. O link H5 permite uma única verificação concluída e se torna inválido após o uso.

Trate Result.H5Link como uma URL opaca do navegador: abra-a como página de nível superior e não a analise, decodifique, reescreva nem incorpore. A TokenLab gerencia a transferência do navegador e a ponte de callback.

Exemplo de requisiçãoCopy 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"}'

Exemplo de respostaCopy 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"
  }
}

Os erros usam a mesma estrutura de nível superior. Leia ResponseMetadata.Error.Code e ResponseMetadata.Error.Message em vez dos campos de erro das outras APIs /v1 do TokenLab.

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

{  "id": "string"}