Télécharger une exportation
GET /fapi/v1/me/exports/{export_id}/download · appelé depuis l'hôte de connexion de l'environnement
Renvoie le paquet ZIP d'une des exportations terminées de l'utilisateur connecté, sous forme de pièce jointe (Content-Type: application/zip, Content-Disposition: attachment; filename="user-export-job_….zip"). Comparez le fichier avec file.sha256 de l'exportation pour le vérifier. Chaque téléchargement est enregistré dans le journal d'audit de l'environnement avant l'envoi du premier octet. Si le transfert est interrompu, la connexion est fermée afin qu'un fichier partiel ne semble jamais complet ; téléchargez-le à nouveau.
Une connexion récente est requise, comme pour la demande : si la session n'a pas été vérifiée au cours des 5 dernières minutes, ou si l'utilisateur dispose d'un second facteur que la session n'a pas utilisé, la réponse est 401 step_up_required. HEAD n'est pas pris en charge (405).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Réponse
200 OK avec le fichier ZIP dans le corps de la réponse.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
Connexion datant de plus de 5 minutes, ou second facteur requis ; l'en-tête WWW-Authenticate contient max_age=300 (et acr_values lorsqu'un second facteur est requis). |
| 404 | not_found |
Cette exportation n'existe pas pour l'utilisateur. |
| 409 | conflict |
L'exportation n'est pas encore terminée, ou son fichier a expiré. |
| 503 | service_unavailable |
L'annuaire des utilisateurs est temporairement indisponible ; réessayez après Retry-After. |
Exemple
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
Données personnelles
Cet endpoint traite des données personnelles : profil de l'utilisateur final, identifiants, identités liées, sessions, appartenances et invitations aux organisations, enregistrements de consentement, journaux de l'environnement et demandes de confidentialité (le paquet contient les données propres à l'utilisateur de chacun de ces types). Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.