删除会话与个人数据
如何删除一个核验会话及其产生的一切数据 - 以及删除具体会影响什么、不会影响什么。删除是立即生效且不可逆的。
从控制台或 API 删除一个会话,它就会彻底消失 - 判定结果、提取出的数据、每一项功能记录, 以及全部媒体文件。删除是立即生效且不可逆的,因此请先导出你需要的任何内容。
你可以随时从 Business Console 或通过 API,删除一个核验会话及其产生的一切数据。 删除是立即生效的,且无法撤销。
#从控制台删除一个会话
- 打开 Verifications
在 Business Console 中进入Dashboard > Verifications。
- 找到该会话
搜索或筛选出你要删除的会话。
- 删除
点击Delete并确认。

- More options 中包含该会话的删除操作。
- 请先确认这是正确的会话 - 删除操作是不可逆的。
#通过 API 删除一个会话
使用会话 ID 调用删除接口:
curl -X DELETE https://verification.didit.me/v3/session/SESSION_ID/delete/ \
-H "x-api-key: YOUR_API_KEY"
调用成功会返回 204 No Content。404 表示该会话已被删除,或该 ID 不存在。
这个接口对个人核验(KYC)和企业核验(KYB)会话都适用。
#删除会包含哪些内容
删除一个会话会移除该会话本身,以及:
- 它的判定结果和全部提取出的数据。
- 每一项相关的功能记录 - 身份证件核验、登记机构查询、证件、AML 结果等等。
- 全部存储的媒体文件 - 证件图像、视频、证件照、自拍照,以及与该会话相关的其他任何上传内容。
该会话会立即从你的会话列表和判定查询中消失,删除之前签发的所有媒体链接也会停止生效。
被删除的会话无法恢复。请在删除之前先导出你需要的任何内容 - 判定 PDF、CSV 行数据等。 参见下载核验报告。
#删除不会影响什么
有几项内容由单独的机制处理,删除会话时不会一并移除:
- 该会话生成的黑名单条目会继续保留。如需移除,请直接从黑名单中操作。
- 已为该会话签发的托管流程链接不会被撤销。
- 已经排入队列的 webhook 投递仍会照常送达。删除操作本身不会触发任何 webhook。
- 该次核验已花费的额度不会被退回。
- 该会话所属的用户或企业不会被删除 - 删除会话只会移除这一次核验。
- 记录 API 活动的审计日志条目属于活动记录,按其自身独立的 365 天周期保留。 参见使用审计日志。
#删除会影响未来的重复检测
重复检测的原理,是把一张新的人脸与你当前仍然持有的数据进行比对。 一旦某个会话被删除,它所包含的人脸也就不再存在,无法用于比对 - 因此如果同一个人之后再次核验, 那次尝试将不会被识别为与已删除会话的重复。
这就是数据最小化与欺诈检测之间真正的取舍,与其事后才发现,不如提前主动做出决定。 参见重复账号与人脸检索。
#一次删除多个会话
如果想一次性删除多个会话,而不是逐个操作,请使用批量删除接口。 请求格式参见 Delete Session API。
如果你需要清除一大批历史数据 - 比如一个测试阶段的数据,或一个已下线的应用 - 而批量接口在这种规模下不够实用, 请联系支持团队,而不要用脚本以高并发方式循环调用 API,那样会触发速率限制。
#用保留窗口自动完成
除了逐个删除会话之外,你也可以设置一个保留窗口,让系统自动应用。 在 Business Console → App Settings → Data retention 中配置:可选范围从1 个月到 10 年,也可以设为不限。 该策略按应用设置,因此不同产品可以设置不同的窗口,并且对未来和已有的会话都同样生效。
#处理后即删除
如果追求最大程度的数据最小化,可以选择完全不保留数据:
- 创建会话
你的后端照常调用创建会话的 API。
- 让检查运行
身份核验、活体检测、AML 以及工作流中配置的其他任何检查。
- 接收 webhook
你会收到状态、会话 ID、你的
vendor_data,以及完整的核验数据。 - 只保留你需要的内容
只存储自身记录所需的最少信息 - 通常只是状态和你自己的引用编号,如果需要作为证据,再加上 PDF。
- 删除该会话
对该会话 ID 调用删除接口。
如果你的义务是自己持有证据,而不是依赖服务商为你保存,这是当前可用的最强数据最小化方案,值得考虑。
#如果你自身的义务要求你保留记录
部分受监管企业的法定记录保留期,会长于它们希望处理者为自己保存数据的期限。 同时满足两者的方法,是在做出判定的那一刻导出证据,把它保存在你自己系统的自有管控之下, 再用一个较短的保留窗口来处理这里的副本。
你的义务具体是什么、需要保留多久,是你团队需要做出的法律和合规决策。 不要从一篇帮助文章中推断答案 - 先做出决定,再据此配置保留期和你自己的归档方式。
