跳转到主要内容
POST
Python
Didit 的异步 Reports API 会重新运行导出,或将选定的失败验证项加入重试队列。新的重试请求返回 201;与已有失败项选择完全相同的请求则返回已有报告,状态码为 200。
选择性重试需要原始请求用户的身份。不带该身份的 API 密钥或应用令牌在发送 item_ids 时会收到 403,即使是其自身应用的请求也是如此。生成的 API 密钥示例会以空请求体重新运行整个导出。
请从 获取异步报告 读取实时 ID,并遵循 失败项重试指南。发送 1 到 1000 个 ID,这些 ID 须来自 READY 或 FAILED 状态的 SESSION_EXPORT,且不得附带替换日期范围。已删除的会话无法重试。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

organization_id
string<uuid>
必填

组织 ID。

application_id
string<uuid>
必填

应用 ID。

report_uuid
string<uuid>
必填

报告 UUID。

请求体

application/json
item_ids
string<uuid>[]

可选,从本次导出中选择 1 至 1000 个失败的实时会话 UUID。重复项会被合并。只有原始请求发起人可以重试部分会话。不能与 date_from/date_to 同时使用。

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

可选的替换时间段开始日期。两个日期需按顺序一并发送;重试失败项时请省略。

date_to
string<date>

可选的替换时间段结束日期,需晚于或等于 date_from。

notify_on_ready
boolean
默认值:false

报告就绪后,若有请求人邮箱,则向其发送邮件。

响应

与之前失败项选择完全相同的重放请求;返回已有的重试报告,不会再次排队。

uuid
string<uuid>
必填

报告标识符。

report_type
enum<string>
必填

导出或合规报告类型。

可用选项:
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
必填

报告类型的显示标签。

status
enum<string>
必填

生成状态。READY 可能包含单个失败项;请检查 failed_count。

可用选项:
PENDING,
PROCESSING,
READY,
FAILED
status_display
string
必填

生成状态的显示标签。

parameters
object
必填

原始导出选项;键名取决于 report_type。

requested_by_user_id
string<uuid> | null
必填

原始请求发起人的身份;对于没有用户身份的调用方为 null。

requested_by_email
string | null
必填

请求发起人的邮箱(如有)。

requested_by_name
string | null
必填

请求发起人的显示名称(如有)。

row_count
integer | null
必填

导出记录的数量;生成前为 null。

failed_item_ids
string<uuid>[]
必填

本次验证导出中失败的实时会话 UUID。已删除的会话不计入。可使用这些 ID 进行选择性重试。

failed_count
integer
必填

failed_item_ids 中的条目数。

必填范围: x >= 0
file_size
integer<int64> | null
必填

生成文件的总大小(字节);生成前为 null。

files
object[]
必填

已生成文件的元数据;不包含下载 URL。

scheduled_report
string<uuid> | null
必填

调度标识符;对于未调度的报告为 null。

error_message
string | null
必填

生成错误(如有)。

deletion_pending
boolean
必填

请求的删除是否仍在进行中。

eta_seconds
integer | null
必填

待处理或处理中报告预计完成所需的秒数;无历史记录或已完成时为 null。

started_at
string<date-time> | null
必填

生成开始时间。

completed_at
string<date-time> | null
必填

生成完成时间。

expires_at
string<date-time>
必填

报告过期时间。

created_at
string<date-time>
必填

创建时间。

updated_at
string<date-time>
必填

最后更新时间。

最后修改于 2026年11月14日