Exportar mis datos
POST /fapi/v1/me/exports · llamado desde el host de inicio de sesión del entorno
Inicia una exportación de los datos propios del usuario que ha iniciado sesión (artículos 15 y 20 de GDPR). El paquete se prepara en segundo plano; cuando está listo, el usuario recibe un correo electrónico en el idioma de la solicitud, y el archivo puede descargarse con Descargar una exportación durante 7 días.
El paquete es un archivo ZIP con un archivo JSON por cada tipo de dato: perfil, direcciones de correo electrónico y números de teléfono, identidades vinculadas, autenticadores (sin secretos), sesiones con sus direcciones IP, pertenencias a organizaciones, concesiones de OAuth, consentimientos y eventos de inicio de sesión. Nunca contiene un hash de contraseña, una semilla TOTP, códigos de recuperación, tokens ni app_metadata.
Requiere un inicio de sesión reciente: si la sesión no se verificó en los últimos 5 minutos, o el usuario tiene un segundo factor y la sesión no lo utilizó, la respuesta es 401 step_up_required y no se inicia nada. Si una exportación del usuario todavía se está preparando, se devuelve esa exportación y no se inicia una nueva. Un usuario puede solicitar como máximo 2 exportaciones en 24 horas.
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK. |
Origin |
sí | Debe ser exactamente https://<host de inicio de sesión>. |
Cuerpo:
{}
Respuesta
202 Accepted:
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
"created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
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). |
| 403 | origin_not_allowed |
Origin falta o es incorrecto. |
| 429 | export_rate_limited |
Ya se solicitaron dos exportaciones en las últimas 24 horas; reintente después de Retry-After. |
| 429 | rate_limited |
Se están preparando demasiadas exportaciones en el entorno; reintente después de Retry-After. |
| 503 | service_unavailable |
El directorio de usuarios no está disponible temporalmente; reintente después de Retry-After. |
Ejemplo
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Datos personales
Este endpoint contiene datos personales: solicitudes de privacidad (los registros de exportación propios del usuario). Datos personales en las API de KeenAuth describe qué se almacena, durante 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.