跳转到主要内容
GET
curl

概览

返回通过 为用户切换 AML 监控 或 为企业切换 AML 监控 启动的 AML 持续监控任务,包括其状态、按结果分类的计数器,以及每个已处理用户或企业对应的一条 results 记录。 超过 20 个档案的选择会在后台运行,切换调用会返回 202 和 PENDING 状态的任务。请每隔几秒轮询此 endpoint,直到 status 变为 COMPLETED 或 FAILED。results 会随档案处理而逐步填充,按处理顺序排列,任务变为 COMPLETED 后即完整。仅通过 API 启动的任务会记录每条记录的结果;从企业控制台启动的任务只报告计数器。

任务状态

每条记录的 outcome 值在切换页面中有说明。

权限

应用的任何处于活动状态的 API 密钥均可调用此 endpoint。任务仅对创建它的应用可见;使用其他 job_id 将返回 404。

相关链接

授权

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。

路径参数

job_id
string<uuid>
必填

开关切换 endpoint 返回的 job_id。

响应

作业。

job_id
string<uuid>
status
enum<string>
可用选项:
PENDING,
PROCESSING,
COMPLETED,
FAILED
is_enabled
boolean

当任务启用监控时为 true,停用监控时为 false。

target_type
enum<string>

该作业切换哪个配置文件系列。

可用选项:
user,
business
total
integer

该任务处理的档案。

processed
integer

截至目前已处理的档案。

outcomes
object

每条记录的结果计数器。每个选定的个人资料都会准确归入一个计数器;不会静默跳过任何内容。

results
object[]

每个已处理的档案对应一个条目,按处理顺序排列。在任务运行期间逐步增加;状态变为 COMPLETED 时完成。对通过 API 启动的任务进行记录;从 Business Console 启动的任务仅报告计数器。

error
string | null

状态为 FAILED 时的通用失败消息;详细原因保留在平台端。

created_at
string<date-time>
completed_at
string<date-time> | null
最后修改于 2026年11月7日