Saltar al contenido principal
POST
Python
La API de informes asíncronos de Didit vuelve a ejecutar una exportación o pone en cola los elementos de verificación fallidos seleccionados. Un nuevo reintento devuelve 201; una selección idéntica de elementos fallidos devuelve el informe existente con 200.
El reintento selectivo requiere la identidad del usuario solicitante original. Una clave de API o un token de aplicación sin esa identidad recibe 403 al enviar item_ids, incluso para su propia aplicación. El ejemplo generado con clave de API vuelve a ejecutar la exportación completa con un cuerpo vacío.
Obtén los ID activos en Recuperar informe asíncrono y sigue la guía de reintento de elementos fallidos. Envía de 1 a 1000 ID de una SESSION_EXPORT en estado READY o FAILED, sin un intervalo de fechas de reemplazo. No se pueden reintentar las sesiones eliminadas.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Parámetros de ruta

organization_id
string<uuid>
requerido

ID de la organización.

application_id
string<uuid>
requerido

Identificador de la aplicación.

report_uuid
string<uuid>
requerido

UUID del informe.

Cuerpo

application/json
item_ids
string<uuid>[]

Selección opcional de entre 1 y 1000 UUID de sesiones fallidas en vivo de esta exportación. Los duplicados se eliminan. Solo el solicitante original puede reintentar un subconjunto. No se puede combinar con date_from/date_to.

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

Inicio opcional del periodo de reemplazo. Envíe ambas fechas en orden; omítalas para reintentar elementos fallidos.

date_to
string<date>

Fin opcional del periodo de reemplazo, igual o posterior a date_from.

notify_on_ready
boolean
predeterminado:false

Enviar un correo electrónico al solicitante cuando esté listo, si hay un correo del solicitante disponible.

Respuesta

Repetición de una selección idéntica de elementos fallidos; devuelve el informe de reintento existente sin poner otro en cola.

uuid
string<uuid>
requerido

Identificador del informe.

report_type
enum<string>
requerido

Tipo de exportación o de informe de cumplimiento.

Opciones 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
requerido

Etiqueta visible del tipo de informe.

status
enum<string>
requerido

Estado de generación. READY puede incluir fallos individuales; revise failed_count.

Opciones disponibles:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
requerido

Etiqueta visible del estado de generación.

parameters
object
requerido

Opciones originales de la exportación; las claves dependen de report_type.

requested_by_user_id
string<uuid> | null
requerido

Identidad del solicitante original, o null para quien hace la llamada sin identidad de usuario.

requested_by_email
string | null
requerido

Correo electrónico del solicitante, cuando esté disponible.

requested_by_name
string | null
requerido

Nombre visible del solicitante, cuando esté disponible.

row_count
integer | null
requerido

Número de registros exportados, o null antes de la generación.

failed_item_ids
string<uuid>[]
requerido

UUID de las sesiones en vivo que fallaron en esta exportación de verificación. Las sesiones eliminadas están excluidas. Use estos ID para un reintento selectivo.

failed_count
integer
requerido

Número de entradas en failed_item_ids.

Rango requerido: x >= 0
file_size
integer<int64> | null
requerido

Tamaño total del archivo generado en bytes, o null antes de la generación.

files
object[]
requerido

Metadatos del archivo generado; no contiene URL de descarga.

scheduled_report
string<uuid> | null
requerido

Identificador de la programación, o null en un informe no programado.

error_message
string | null
requerido

Error de generación, cuando esté disponible.

deletion_pending
boolean
requerido

Indica si una eliminación solicitada sigue en curso.

eta_seconds
integer | null
requerido

Segundos estimados hasta la finalización de un informe pendiente o en proceso; null sin historial o cuando ya está terminado.

started_at
string<date-time> | null
requerido

Fecha y hora de inicio de la generación.

completed_at
string<date-time> | null
requerido

Fecha y hora de finalización de la generación.

expires_at
string<date-time>
requerido

Hora de caducidad del informe.

created_at
string<date-time>
requerido

Fecha y hora de creación.

updated_at
string<date-time>
requerido

Fecha y hora de la última actualización.

Última modificación el 14 de noviembre de 2026