Passer au contenu principal
POST
curl
Préparez un seul fichier ZIP contenant tous les fichiers d’une session de Vérification des utilisateurs (KYC) ou de Vérification d’entreprise (KYB) : recto et verso des documents, selfies, vidéos de détection du vivant et documents téléversés, en qualité d’origine. Le ZIP est préparé en arrière-plan. L’appel renvoie 202 avec l’export ; consultez-le avec Obtenir l’export des fichiers jusqu’à ce que status soit READY, puis téléchargez download_url.
  • Tant qu’un export de la même session est encore en cours de préparation, l’appel renvoie cet export au lieu d’en lancer un nouveau.
  • Le ZIP est supprimé 24 heures après sa disponibilité, et immédiatement lorsque la session est supprimée.
  • Une session supprimée ne peut pas être exportée : l’appel renvoie 404.
  • Chaque export est inscrit dans le journal d’audit de la session.
  • Une clé API à portée limitée doit disposer des autorisations media: read et decisions: read.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId
string<uuid>
requis

UUID de la session de vérification (le session_id renvoyé par POST /v3/session/). Accepte les identifiants de session de Vérification des utilisateurs (KYC) et de Vérification d'entreprise (KYB). Une session supprimée renvoie 404.

Exemple:

"11111111-2222-3333-4444-555555555555"

Réponse

L'export, en cours de préparation.

Un fichier ZIP contenant chaque fichier d'une session, dans sa qualité d'origine.

export_id
string<uuid>
requis

Identifiant de l'export. Transmettez-le à GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
requis

La session dont proviennent les fichiers.

status
enum<string>
requis

PENDING et PROCESSING pendant la préparation du ZIP, READY dès qu'il peut être téléchargé, FAILED lorsqu'il n'a pas pu être préparé (demandez un nouvel export), EXPIRED une fois le ZIP supprimé.

Options disponibles:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
requis

Fichiers dans le ZIP. Défini uniquement tant que status est READY.

size_bytes
integer<int64> | null
requis

Taille du ZIP en octets. Renseignée uniquement lorsque status est READY.

download_url
string<uri> | null
requis

URL signée du ZIP, valide pendant une courte durée. Renseignée uniquement lorsque status est READY ; relisez l'export pour en obtenir une nouvelle.

expires_at
string<date-time> | null
requis

Date et heure de suppression du fichier ZIP, 24 heures après qu'il a été prêt. Défini uniquement lorsque status est READY.

error
string | null
requis

Raison pour laquelle l'export a échoué, lorsque status est FAILED.

created_at
string<date-time>
requis

Date et heure de demande de l'export.

completed_at
string<date-time> | null
requis

Date et heure auxquelles le fichier ZIP était prêt ou auxquelles l'export a échoué.

Dernière modification le 7 novembre 2026