Descargar una exportación
GET /fapi/v1/me/exports/{export_id}/download · llamado desde el host de inicio de sesión del entorno
Devuelve el paquete ZIP de una de las exportaciones completadas del usuario que ha iniciado sesión, como archivo adjunto (Content-Type: application/zip, Content-Disposition: attachment; filename="user-export-job_….zip"). Compare el archivo con file.sha256 de la exportación para comprobarlo. Cada descarga se registra en el registro de auditoría del entorno antes de enviar el primer byte. Si la transferencia se interrumpe, la conexión se cierra para que un archivo parcial nunca parezca completo; descárguelo de nuevo.
Requiere un inicio de sesión reciente, igual que la solicitud: si la sesión no se verificó en los últimos 5 minutos, o si el usuario tiene un segundo factor y la sesión no lo usó, la respuesta es 401 step_up_required. HEAD no es compatible (405).
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Respuesta
200 OK con el archivo ZIP como cuerpo.
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 401 | unauthenticated |
No hay una cookie de sesión válida. |
| 401 | step_up_required |
El inicio de sesión tiene más de 5 minutos, o se requiere un segundo factor; el encabezado WWW-Authenticate incluye max_age=300 (y acr_values cuando se requiere un segundo factor). |
| 404 | not_found |
No existe esta exportación del usuario. |
| 409 | conflict |
La exportación aún no está completada o su archivo ha caducado. |
| 503 | service_unavailable |
El directorio de usuarios no está disponible temporalmente; reintente después de Retry-After. |
Ejemplo
curl -OJ https://example.keenauth.app/fapi/v1/me/exports/job_01jbx4k6v8m2c9w5s7r3t1q0zy/download \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Datos personales
Este endpoint contiene datos personales: perfil del usuario final, credenciales, identidades vinculadas, sesiones, membresías y invitaciones de organizaciones, registros de consentimiento, registros del entorno y solicitudes de privacidad (el paquete contiene los datos propios del usuario de cada uno de estos tipos). Datos personales en las API de KeenAuth describe qué se almacena, cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.