Saltar al contingut principal
POST
Python
L’API d’informes asíncrona de Didit torna a executar una exportació o posa en cua els elements de verificació fallits seleccionats. Un nou reintent retorna 201; una selecció idèntica d’elements fallits retorna l’informe existent amb 200.
El reintent selectiu requereix la identitat d’usuari del sol·licitant original. Una clau d’API o un token d’aplicació sense aquesta identitat rep 403 en enviar item_ids, fins i tot per a la seva pròpia aplicació. L’exemple de clau d’API generat torna a executar tota l’exportació amb un cos buit.
Obteniu els IDs actuals des de Recuperar informe asíncron i seguiu la guia de reintent d’elements fallits. Envieu d’1 a 1000 IDs d’una SESSION_EXPORT amb estat READY o FAILED, sense un interval de dates de substitució. Les sessions eliminades no es poden reintentar.

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

organization_id
string<uuid>
requerit

Identificador de l'organització.

application_id
string<uuid>
requerit

Identificador de l'aplicació.

report_uuid
string<uuid>
requerit

UUID de l'informe.

Cos

application/json
item_ids
string<uuid>[]

Selecció opcional d'entre 1 i 1000 UUID de sessions en directe fallides d'aquesta exportació. Els duplicats es redueixen a una sola entrada. Només el sol·licitant original pot reintentar un subconjunt. No es pot combinar amb date_from/date_to.

Required array length: 1 - 1000 elements
date_from
string<date>

Data d'inici opcional del període de substitució. Envia les dues dates en ordre; omet-les per reintentar un element fallit.

date_to
string<date>

Data de fi opcional del període de substitució, igual o posterior a date_from.

notify_on_ready
boolean
predeterminat:false

Envia un correu electrònic al sol·licitant quan estigui llest, si hi ha un correu electrònic del sol·licitant disponible.

Resposta

Repetició d'una selecció d'elements fallits idèntica; retorna l'informe de reintent existent sense posar-ne cap altre en cua.

uuid
string<uuid>
requerit

Identificador de l'informe.

report_type
enum<string>
requerit

Tipus d'exportació o d'informe de compliment.

Opcions disponibles:
SESSION_EXPORT,
TRANSACTION_EXPORT,
BUSINESS_EXPORT,
VENDOR_USER_EXPORT,
VENDOR_BUSINESS_EXPORT,
CASE_EXPORT,
CASE_SLA_EXPORT,
LIST_ENTRY_EXPORT,
EVENT_EXPORT,
COMPLIANCE_KYC_KYB,
COMPLIANCE_AML_LOG,
COMPLIANCE_TRAVEL_RULE,
COMPLIANCE_SANCTIONS_PEP,
COMPLIANCE_RISK_SUMMARY,
COMPLIANCE_SAR_STR_DRAFT,
COMPLIANCE_CTR,
COMPLIANCE_CASE_SUMMARY
report_type_display
string
requerit

Etiqueta visible del tipus d'informe.

status
enum<string>
requerit

Estat de generació. READY pot incloure fallades individuals; revisa failed_count.

Opcions disponibles:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
requerit

Etiqueta visible de l'estat de generació.

parameters
object
requerit

Opcions originals de l'exportació; les claus depenen de report_type.

requested_by_user_id
string<uuid> | null
requerit

Identitat del sol·licitant original, o null per a les crides sense identitat d'usuari.

requested_by_email
string | null
requerit

Correu electrònic del sol·licitant, quan està disponible.

requested_by_name
string | null
requerit

Nom visible del sol·licitant, quan està disponible.

row_count
integer | null
requerit

Nombre de registres exportats, o null abans de la generació.

failed_item_ids
string<uuid>[]
requerit

UUID de les sessions en directe que han fallat en aquesta exportació de verificació. Les sessions eliminades queden excloses. Utilitza aquests IDs per a un reintent selectiu.

failed_count
integer
requerit

Nombre d'entrades a failed_item_ids.

Rang requerit: x >= 0
file_size
integer<int64> | null
requerit

Mida total del fitxer generat en bytes, o null abans de la generació.

files
object[]
requerit

Metadades del fitxer generat; no conté URL de descàrrega.

scheduled_report
string<uuid> | null
requerit

Identificador de la programació, o null per a un informe no programat.

error_message
string | null
requerit

Error de generació, quan estigui disponible.

deletion_pending
boolean
requerit

Indica si una eliminació sol·licitada encara està en curs.

eta_seconds
integer | null
requerit

Segons estimats fins a la finalització per a un informe pendent o en procés; null sense historial o quan ja s'ha completat.

started_at
string<date-time> | null
requerit

Hora d'inici de la generació.

completed_at
string<date-time> | null
requerit

Hora de finalització de la generació.

expires_at
string<date-time>
requerit

Data i hora en què caduca l'informe.

created_at
string<date-time>
requerit

Hora de creació.

updated_at
string<date-time>
requerit

Hora de l'última actualització.

Darrera modificació el 14 de novembre del 2026