Passer au contenu principal
POST
Python
L’API de rapports asynchrone de Didit relance une exportation ou met en file d’attente les éléments de vérification échoués sélectionnés. Un nouveau réessai renvoie 201 ; une sélection identique d’éléments échoués renvoie le rapport existant avec 200.
Le réessai sélectif exige l’identité de l’utilisateur demandeur d’origine. Une clé API ou un token d’application sans cette identité reçoit 403 lorsqu’il envoie item_ids, même pour sa propre application. L’exemple de clé API généré relance l’exportation complète avec un corps vide.
Récupérez les identifiants à jour dans Récupérer un rapport asynchrone et suivez les consignes de réessai des éléments échoués. Envoyez de 1 à 1 000 identifiants provenant d’un SESSION_EXPORT au statut READY ou FAILED, sans plage de dates de remplacement. Les sessions supprimées ne peuvent pas faire l’objet d’un réessai.

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

organization_id
string<uuid>
requis

Identifiant de l'organisation.

application_id
string<uuid>
requis

Identifiant de l'application.

report_uuid
string<uuid>
requis

UUID du rapport.

Corps

application/json
item_ids
string<uuid>[]

Sélection facultative de 1 à 1000 UUID de sessions en production ayant échoué, issus de cet export. Les doublons sont fusionnés. Seul le demandeur d'origine peut relancer un sous-ensemble. Ne peut pas être combiné avec date_from/date_to.

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

Début facultatif de la période de remplacement. Envoyez les deux dates dans l'ordre ; omettez-les pour une nouvelle tentative sur un élément en échec.

date_to
string<date>

Fin facultative de la période de remplacement, égale ou postérieure à date_from.

notify_on_ready
boolean
défaut:false

Envoie un e-mail au demandeur une fois le rapport prêt, si son adresse e-mail est disponible.

Réponse

Rejeu d'une sélection d'éléments en échec identique ; renvoie le rapport de nouvelle tentative existant sans en mettre un autre en file d'attente.

uuid
string<uuid>
requis

Identifiant du rapport.

report_type
enum<string>
requis

Type d'export ou de rapport de conformité.

Options 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
requis

Libellé affiché pour le type de rapport.

status
enum<string>
requis

État de génération. READY peut inclure des échecs individuels ; vérifiez failed_count.

Options disponibles:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
requis

Libellé affiché pour l'état de génération.

parameters
object
requis

Options d'export d'origine ; les clés dépendent de report_type.

requested_by_user_id
string<uuid> | null
requis

Identité du demandeur d'origine, ou null pour les appelants sans identité d'utilisateur.

requested_by_email
string | null
requis

E-mail du demandeur, lorsqu'il est disponible.

requested_by_name
string | null
requis

Nom d'affichage du demandeur, lorsqu'il est disponible.

row_count
integer | null
requis

Nombre d'enregistrements exportés, ou null avant la génération.

failed_item_ids
string<uuid>[]
requis

UUID des sessions en production ayant échoué dans cet export de vérification. Les sessions supprimées sont exclues. Utilisez ces identifiants pour une nouvelle tentative sélective.

failed_count
integer
requis

Nombre d'entrées dans failed_item_ids.

Plage requise: x >= 0
file_size
integer<int64> | null
requis

Taille totale du fichier généré en octets, ou null avant la génération.

files
object[]
requis

Métadonnées du fichier généré ; ne contient pas d'URL de téléchargement.

scheduled_report
string<uuid> | null
requis

Identifiant de la planification, ou null pour un rapport non planifié.

error_message
string | null
requis

Erreur de génération, le cas échéant.

deletion_pending
boolean
requis

Indique si une suppression demandée est encore en cours.

eta_seconds
integer | null
requis

Durée estimée en secondes avant la fin de la génération d'un rapport en attente ou en cours de traitement ; null sans historique ou une fois le rapport terminé.

started_at
string<date-time> | null
requis

Heure de début de génération.

completed_at
string<date-time> | null
requis

Heure de fin de génération.

expires_at
string<date-time>
requis

Date d'expiration du rapport.

created_at
string<date-time>
requis

Heure de création.

updated_at
string<date-time>
requis

Heure de la dernière mise à jour.

Dernière modification le 14 novembre 2026