# 可复用验证链接

Source: https://help.didit.me/zh/integration/reusable-links
Updated: 2026-10-12

每个工作流对应一个长期有效的链接，每次访问都会开启一个新的会话，适合网站按钮、二维码或合作伙伴使用。用 vendor_data 附加你自己的标识。

每个工作流都有一个可复用链接，每次访问都会创建**一个新会话**。
把它放在按钮后面，打印成二维码，或交给合作伙伴使用。
在 URL 后附加 `?vendor_data=` 加上你自己的标识，就能分清每个会话属于谁。
从工作流行菜单复制可重复使用的链接，或打开**开发者 → 快速开始 → 托管链接**，那里也提供二维码。

[Video: 无需代码创建验证链接，并筛选任意会话 - Didit Academy](https://www.youtube.com/watch?v=29b0KyRYjKo)

[Video: 可复用 KYC 详解：一次验证，免去重复验证 - Didit Academy](https://www.youtube.com/watch?v=qZao_e_fWt8)

## 一个链接，多个人使用

一次性验证链接属于一个人。
**可复用链接**属于工作流：每次访问都会开启一个全新的会话，因此你可以发布一个 URL，让任意数量的人都能通过它完成验证。

![Didit 控制台中的工作流列表，某个工作流行上有复制链接操作](https://help.didit.me/screenshots/workflows-list-light.webp)

*从任意工作流获取可复用链接，只需一个操作。*

适合的场景：

- 网站上的"验证你的身份"按钮
- 门店、自助终端或活动现场打印的二维码
- 交给分销商、合作伙伴或经销商的链接
- 任何你无法提前知道谁会使用它的场合

## 区分不同的会话

共享同一个链接的明显问题是，所有由此产生的会话看起来都是匿名的。
解决办法是附加你自己的标识：

```
https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID
```

你传入的 `vendor_data` 会随会话一起返回，也会出现在每一次 webhook 中，因此你无需查表就能把结果对应到自己这边正确的记录上。

> **Tip:** 按每个用户生成这个值，可以是你自己的用户 ID，也可以是一个你能解析的签名令牌。
> 这也能让重复检测正常工作：共享同一个 `vendor_data` 的会话会被归并为一个合并用户，因此一位回访客户不会被标记为自己的重复账号。
> 参见[重复账号与人脸检索](https://help.didit.me/zh/verification-sessions/duplicate-detection)。

如果你是为每个访客动态生成这个值，请在服务端生成整个链接。
用户能在地址栏里编辑的 `vendor_data`，也是用户能填入别人证件信息的 `vendor_data`。

## 可复用链接无法提供什么

- **没有针对个人的过期时间。** 一次性会话链接可以设置超时；可复用链接则设计为持续有效。如果你需要一个针对特定人过期的链接，请单独创建一个会话。
- **没有预填的预期信息。** 通过 API 创建会话时，你可以传入姓名或证件号码用于比对。共享链接没有针对每个人的上下文，因此这类比对不可用。
- **无法控制谁来使用它。** 可复用链接是一个公开 URL，任何拿到它的人都能开始一次会话，这对网站按钮来说没问题，但对只想给一个人使用的场景就不太合适。

## 费用仍按工作流计算

通过可复用链接的每一次访问，都是一次针对该工作流的完整会话，计费方式相同。
一个比预期传播更广的链接，会带来一笔比预期更高的账单，因此如果你把链接发布到公开场合，请留意分析中的用量。
参见[查看你的分析数据](https://help.didit.me/zh/account-organization/analytics-dashboard)。

## 它使用哪个工作流

链接绑定在特定应用下的特定工作流上，因此它始终运行该工作流当前发布的版本。
修改工作流会改变新访客得到的内容；已经在进行中的会话会保留它们开始时使用的版本。

## 获取结果

方式和其他地方一样：在控制台中查看，或通过 [webhook](https://help.didit.me/zh/integration/webhooks-basics) 获取结果。
由于这类会话是不可预测地到来的，而不是响应你自己的 API 调用，webhook 在这里比轮询更有用，因为在会话产生之前，你根本没有可轮询的对象。

## 完整参考

参见[验证链接](https://docs.didit.me/console/verification-links)和[可复用链接](https://docs.didit.me/console/uni-links)的控制台操作说明。