跳转到主要内容
POST
curl
将一次验证会话收集的人脸、身份证件、电话号码或电子邮箱地址加入黑名单。Didit 会将每条所选记录标记为已加入黑名单,并将其添加到对应的系统黑名单中,并与该会话关联。此后,人脸、证件号码、电话号码或电子邮箱地址与黑名单匹配的新会话都会被拒绝。
该调用要么全部成功,要么全部不执行:如果会话中没有所选类型的记录,或证件缺少签发国家/地区、证件类型、证件号码或姓名,接口将返回 400,且不会加入任何黑名单。对已在黑名单中的项目重复调用是安全的。
如需查看当前被封禁的内容,请使用列出已加入黑名单的项目。如需解除封禁,请使用从黑名单中移除。如需封禁 IP 地址、设备指纹、用户、企业或不关联会话的值,请使用创建条目将其添加到对应的系统黑名单中。有关黑名单的执行方式,请参阅用户黑名单。

授权

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。

请求体

application/json

至少一个 blocklist_* 标志必须为 true。

session_id
string<uuid>
必填

您应用的个人验证会话。已删除的会话会被拒绝。

blocklist_face
boolean
默认值:false

将该会话的人脸加入黑名单。

blocklist_document
boolean
默认值:false

将该会话的身份证件加入黑名单。证件需要具备签发州、证件类型、证件号码和姓名。

blocklist_phone
boolean
默认值:false

将该会话的电话号码加入黑名单。

blocklist_email
boolean
默认值:false

将该会话的邮箱地址加入黑名单。

响应

所选项目已被列入黑名单。

message
string
必填

始终为 Successfully updated blocklist.

最后修改于 2026年11月7日