Saltar al contingut principal
POST
curl
Prepara un únic ZIP amb tots els fitxers d’una sessió de Verificació d’usuaris (KYC) o Verificació d’empreses (KYB): cares dels documents, selfies, vídeos de prova de vida i documents pujats, en qualitat original. El ZIP es prepara en segon pla. La crida respon amb 202 i l’exportació; llegeix-la amb Obtenir l’exportació de fitxers fins que status sigui READY, i després descarrega download_url.
  • Mentre s’està preparant una exportació de la mateixa sessió, la crida retorna aquesta exportació en lloc d’iniciar-ne una de nova.
  • El ZIP se suprimeix 24 hores després de quedar a punt, i de seguida quan se suprimeix la sessió.
  • Una sessió suprimida no es pot exportar: la crida retorna 404.
  • Cada exportació s’escriu al registre d’auditoria de la sessió.
  • Una clau d’API amb àmbit limitat necessita media: read i decisions: read.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

sessionId
string<uuid>
requerit

UUID de la sessió de verificació (el session_id retornat per POST /v3/session/). Accepta tant IDs de sessió de Verificació d'usuaris (KYC) com de Verificació d'empreses (KYB). Una sessió eliminada retorna 404.

Exemple:

"11111111-2222-3333-4444-555555555555"

Resposta

L'exportació, en preparació.

Un ZIP amb tots els fitxers d'una sessió, amb la qualitat original.

export_id
string<uuid>
requerit

ID de l'exportació. Passa'l a GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
requerit

La sessió d'on provenen els fitxers.

status
enum<string>
requerit

PENDING i PROCESSING mentre es prepara el ZIP, READY un cop es pot descarregar, FAILED quan no s'ha pogut preparar (sol·licita una nova exportació), EXPIRED un cop s'ha suprimit el ZIP.

Opcions disponibles:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
requerit

Fitxers del ZIP. Només s'estableix mentre status és READY.

size_bytes
integer<int64> | null
requerit

Mida del ZIP en bytes. Només s'estableix mentre status és READY.

download_url
string<uri> | null
requerit

URL signada del ZIP, vàlida durant un període curt. Només s'estableix mentre status és READY; torna a llegir l'exportació per obtenir-ne una de nova.

expires_at
string<date-time> | null
requerit

Quan s'elimina el ZIP, 24 hores després d'estar llest. S'estableix només mentre status és READY.

error
string | null
requerit

Per què ha fallat l'exportació, quan status és FAILED.

created_at
string<date-time>
requerit

Quan es va sol·licitar l'exportació.

completed_at
string<date-time> | null
requerit

Quan el ZIP va estar llest o l'exportació va fallar.

Darrera modificació el 7 de novembre del 2026