Vai al contenuto principale
POST
Python
L’API Reports asincrona di Didit riesegue un’esportazione oppure accoda gli elementi di verifica non riusciti selezionati. Un nuovo tentativo restituisce 201; una selezione identica di elementi non riusciti restituisce il report esistente con 200.
Il nuovo tentativo selettivo richiede l’identità dell’utente richiedente originale. Una chiave API o un token dell’applicazione senza tale identità riceve 403 quando invia item_ids, anche per la propria applicazione. L’esempio generato per la chiave API riesegue l’intera esportazione con un corpo vuoto.
Leggi gli ID attivi da Recupera report asincrono e segui le indicazioni per il nuovo tentativo degli elementi non riusciti. Invia da 1 a 1000 ID di una SESSION_EXPORT in stato READY o FAILED, senza un intervallo di date sostitutivo. Le sessioni eliminate non possono essere sottoposte a nuovo tentativo.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

organization_id
string<uuid>
obbligatorio

ID dell'organizzazione.

application_id
string<uuid>
obbligatorio

ID dell'applicazione.

report_uuid
string<uuid>
obbligatorio

UUID del report.

Corpo

application/json
item_ids
string<uuid>[]

Selezione facoltativa da 1 a 1000 UUID di sessioni live non riuscite di questa esportazione. I duplicati vengono unificati. Solo il richiedente originale può ritentare un sottoinsieme. Non può essere combinata con date_from/date_to.

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

Data di inizio facoltativa del periodo sostitutivo. Invia entrambe le date in ordine; omettile per un nuovo tentativo sugli elementi non riusciti.

date_to
string<date>

Data di fine facoltativa del periodo sostitutivo, uguale o successiva a date_from.

notify_on_ready
boolean
predefinito:false

Invia un'email al richiedente quando il report è pronto, se è disponibile un'email del richiedente.

Risposta

Replay di una selezione di elementi falliti identica; restituisce il report di nuovo tentativo esistente senza accodarne un altro.

uuid
string<uuid>
obbligatorio

Identificatore del report.

report_type
enum<string>
obbligatorio

Tipo di esportazione o di report di conformità.

Opzioni disponibili:
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
obbligatorio

Etichetta visualizzata per il tipo di report.

status
enum<string>
obbligatorio

Stato di generazione. READY può includere singoli errori; controlla failed_count.

Opzioni disponibili:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
obbligatorio

Etichetta visualizzata per lo stato di generazione.

parameters
object
obbligatorio

Opzioni originali dell'esportazione; le chiavi dipendono da report_type.

requested_by_user_id
string<uuid> | null
obbligatorio

Identità del richiedente originale, oppure null per i chiamanti senza identità utente.

requested_by_email
string | null
obbligatorio

Email del richiedente, quando disponibile.

requested_by_name
string | null
obbligatorio

Nome visualizzato del richiedente, quando disponibile.

row_count
integer | null
obbligatorio

Numero di record esportati, oppure null prima della generazione.

failed_item_ids
string<uuid>[]
obbligatorio

UUID delle sessioni live non riuscite in questa esportazione della verifica. Le sessioni eliminate sono escluse. Usa questi ID per un nuovo tentativo selettivo.

failed_count
integer
obbligatorio

Numero di voci in failed_item_ids.

Intervallo richiesto: x >= 0
file_size
integer<int64> | null
obbligatorio

Dimensione totale del file generato in byte, oppure null prima della generazione.

files
object[]
obbligatorio

Metadati del file generato; non contiene URL di download.

scheduled_report
string<uuid> | null
obbligatorio

Identificatore della pianificazione, oppure null per un report non pianificato.

error_message
string | null
obbligatorio

Errore di generazione, se disponibile.

deletion_pending
boolean
obbligatorio

Indica se un'eliminazione richiesta è ancora in corso.

eta_seconds
integer | null
obbligatorio

Secondi stimati al completamento per un report in attesa o in elaborazione; null senza cronologia o quando è completato.

started_at
string<date-time> | null
obbligatorio

Data di inizio della generazione.

completed_at
string<date-time> | null
obbligatorio

Data di completamento della generazione.

expires_at
string<date-time>
obbligatorio

Ora di scadenza del report.

created_at
string<date-time>
obbligatorio

Data di creazione.

updated_at
string<date-time>
obbligatorio

Data dell'ultimo aggiornamento.

Ultima modifica il 14 novembre 2026