可复用验证链接
每个工作流对应一个长期有效的链接,每次访问都会开启一个新的会话,适合网站按钮、二维码或合作伙伴使用。用 vendor_data 附加你自己的标识。
每个工作流都有一个可复用链接,每次访问都会创建一个新会话。
把它放在按钮后面,打印成二维码,或交给合作伙伴使用。
在 URL 后附加 ?vendor_data= 加上你自己的标识,就能分清每个会话属于谁。
#一个链接,多个人使用
一次性验证链接属于一个人。 可复用链接属于工作流:每次访问都会开启一个全新的会话,因此你可以发布一个 URL,让任意数量的人都能通过它完成验证。

- 复制链接会给出一个任何人都能打开的 URL,无需调用 API。
- 链接会运行该工作流包含的所有内容,因此请先检查它的功能。
- 不同的工作流对应不同的链接,这也是区分不同活动的方式。
适合的场景:
- 网站上的"验证你的身份"按钮
- 门店、自助终端或活动现场打印的二维码
- 交给分销商、合作伙伴或经销商的链接
- 任何你无法提前知道谁会使用它的场合
#区分不同的会话
共享同一个链接的明显问题是,所有由此产生的会话看起来都是匿名的。 解决办法是附加你自己的标识:
https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID
你传入的 vendor_data 会随会话一起返回,也会出现在每一次 webhook 中,因此你无需查表就能把结果对应到自己这边正确的记录上。
按每个用户生成这个值,可以是你自己的用户 ID,也可以是一个你能解析的签名令牌。
这也能让重复检测正常工作:共享同一个 vendor_data 的会话会被归并为一个合并用户,因此一位回访客户不会被标记为自己的重复账号。
参见重复账号与人脸检索。
如果你是为每个访客动态生成这个值,请在服务端生成整个链接。
用户能在地址栏里编辑的 vendor_data,也是用户能填入别人证件信息的 vendor_data。
#可复用链接无法提供什么
- 没有针对个人的过期时间。 一次性会话链接可以设置超时;可复用链接则设计为持续有效。如果你需要一个针对特定人过期的链接,请单独创建一个会话。
- 没有预填的预期信息。 通过 API 创建会话时,你可以传入姓名或证件号码用于比对。共享链接没有针对每个人的上下文,因此这类比对不可用。
- 无法控制谁来使用它。 可复用链接是一个公开 URL,任何拿到它的人都能开始一次会话,这对网站按钮来说没问题,但对只想给一个人使用的场景就不太合适。
#费用仍按工作流计算
通过可复用链接的每一次访问,都是一次针对该工作流的完整会话,计费方式相同。 一个比预期传播更广的链接,会带来一笔比预期更高的账单,因此如果你把链接发布到公开场合,请留意分析中的用量。 参见查看你的分析数据。
#它使用哪个工作流
链接绑定在特定应用下的特定工作流上,因此它始终运行该工作流当前发布的版本。 修改工作流会改变新访客得到的内容;已经在进行中的会话会保留它们开始时使用的版本。
#获取结果
方式和其他地方一样:在控制台中查看,或通过 webhook 获取结果。 由于这类会话是不可预测地到来的,而不是响应你自己的 API 调用,webhook 在这里比轮询更有用,因为在会话产生之前,你根本没有可轮询的对象。
