api

Generar Detalle de Sesión PDF

Descripción

Endpoint para descargar un reporte PDF que resume una sesión KYC completa usando el identificador de la sesión.

Endpoint

GET /api/v1/kyc/session/{id}/pdf

Método: GET Autenticación: Requerida (Bearer Token) Tipo de Respuesta: application/octet-stream

Parámetros

ParámetroTipoRequeridoEjemplo
id (path)string6994bf1c1f24bffaedfbb9e5
Authorization (header)stringBearer TU_API_TOKEN

Ambientes

AmbienteURL
Sandboxhttps://sandbox.api.jaak.ai
Producciónhttps://services.api.jaak.ai

Ejemplos de Solicitud

cURL

curl -X GET \
  "https://sandbox.api.jaak.ai/api/v1/kyc/session/6994bf1c1f24bffaedfbb9e5/pdf" \
  -H "Authorization: Bearer {TU_API_TOKEN}" \
  -H "Accept: application/octet-stream" \
  --output "session_report.pdf"

JavaScript/Fetch

const response = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
const blob = await response.blob();
// Disparar descarga o abrir en nueva pestaña

Python

response = requests.get(url, headers=headers, stream=True)
with open('report.pdf', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

Respuestas

200 OK - Éxito

PDF retornado como stream binario con headers:

Content-Disposition: attachment; filename="session_{id}.pdf"

Códigos de Error

CódigoSignificado
400ID inválido o formato incorrecto
401Token de autenticación inválido
404Sesión no encontrada
500Error del servidor interno

Buenas Prácticas

  • Manejo Binario: Manejar la respuesta siempre como stream binario para evitar corrupción
  • Nomenclatura: Nombrar archivos con ID de sesión para rastreabilidad
  • Reintentos: Implementar backoff exponencial para errores 5xx; no reintentar 4xx sin correcciones
  • Estado: Verificar que la sesión haya completado procesamiento antes de solicitar PDF

Soporte

Email: support@jaak.ai