Saltar al contingut principal
GET
curl
Llegeix una exportació iniciada amb Exporta fitxers.
  • PENDING i PROCESSING: el ZIP s’està preparant. Torna a llegir l’exportació d’aquí a uns segons.
  • READY: download_url és un enllaç signat al ZIP que és vàlid durant poc temps. Torna a llegir l’exportació per obtenir un enllaç nou fins a expires_at.
  • FAILED: no s’ha pogut preparar el ZIP. Inicia una nova exportació.
  • EXPIRED: el ZIP s’ha eliminat. Inicia una nova exportació.
Cada lectura que proporciona un enllaç de descàrrega queda registrada al registre d’auditoria de la sessió. Una exportació d’una sessió eliminada retorna 404.

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"

exportId
string<uuid>
requerit

L'export_id retornat per POST /v3/session/{sessionId}/files-export/.

Exemple:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Resposta

L'exportació.

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