Skip to main content
GET
/
api
/
kyc
/
validations
/
{id}
/
media
Obter mídia da validação KYC
curl --request GET \
  --url http://api.gu1.ai/api/kyc/validations/{id}/media \
  --header 'Authorization: Bearer <token>'

​
Resumo

Quando uma validação KYC por sessão termina (ex.: approved), referências a mídia aparecem em decision na resposta de GET /api/kyc/validations/:id (imagens do documento, retrato, vídeo de liveness, etc.). Formato usual: cada referência é uma chave kyc/... (string de caminho). Para baixar os bytes, use o endpoint de mídia abaixo com sua API key. Formato de decision: resultados aparecem como objeto singular e array de um elemento (ex.: id_verification e id_verifications[0]). O Gu1 mantém ambos sincronizados. Veja Eventos webhook KYC para um exemplo completo. Validações antigas: alguns registros ainda têm URLs https://... em decision (links temporários do fluxo de verificação). Use essas URLs diretamente (por exemplo em <img> ou fetch) enquanto forem válidas. Não use em GET .../media?key= — esse parâmetro é só para chaves kyc/.... Esta página é para o KYC completo por sessão (global_gueno_validation_kyc). Face Match e ID Verification usam outros endpoints (barra lateral).
  • Nenhum dado é apagado: o JSON continua válido; o que muda é se cada campo é URL ou chave kyc/....
  • Chaves kyc/...: use GET /api/kyc/validations/:id/media com key codificada na URL. O acesso fica limitado à sua organização e àquela validação.
  • Strings https://: trate como URLs temporárias de arquivo até expirarem. A API pode substituí-las por chaves kyc/... numa sincronização posterior com o provedor de verificação (webhook ou sync), se o link ainda puder ser baixado.
  • Se o link já expirou antes da migração, o campo pode ficar como URL inválida até uma nova sync trazer links novos ou o suporte Gu1 executar uma reparação interna de mídia para a sua organização.

​
Solicitação

​
Endpoint

GET https://api.gu1.ai/api/kyc/validations/{validationId}/media

​
Headers

  • Authorization: Bearer SUA_API_KEY (obrigatório)

​
Query parameters

ParâmetroObrigatórioDescrição
keySimA string de chave vinda de decision. Codifique na URL (encodeURIComponent; barras viram %2F).

​
Permissões

A API key precisa poder ler KYC (kyc:read com permissões granulares; caso contrário, aplica-se o papel do usuário dono da chave, com fallback legado onde couber—igual a GET /api/kyc/validations/:id).

​
Resposta

Corpo bruto do arquivo. O Content-Type reflete o tipo (ex.: image/jpeg, video/webm).

​
Exemplo

curl -sS -o portrait.jpg \
  -H "Authorization: Bearer SUA_API_KEY" \
  "https://api.gu1.ai/api/kyc/validations/UUID_VALIDACAO/media?key=kyc%2Fglobal_gueno_validation_kyc%2F..."
No código da aplicação, use encodeURIComponent(key) na query.
O parâmetro key não é segredo e não substitui autenticação. Envie sempre Authorization: Bearer válido; a API verifica se a chave do objeto pertence àquela validação e à sua organização.

​
Relacionado