跳转到主要内容
GET
Python
Didit 的异步 Reports API 会返回一个导出任务及其当前的失败列表。failed_count 等于 failed_item_ids 的长度;已删除的会话会被排除在外。 使用列出异步报告查找报告,然后参阅重试指南,或直接重试导出。

授权

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。

响应

获取异步报告。

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日