# 集成方式：API、SDK 与无代码链接

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

使用 Didit 验证用户不一定需要写代码：可以用无代码链接，也可以在需要自动化时接入 SDK 或 API。

共有三种途径。
**无代码链接**完全不需要后端。
**API 加上重定向**是标准的集成方式。
**SDK** 把整个流程嵌入你自己的应用中，也是唯一支持 NFC 的方式。
无论你选择哪种，都通过 [webhook](https://help.didit.me/zh/integration/webhooks-basics) 获取结果。

[Video: 完整集成指南 - Didit Academy](https://www.youtube.com/watch?v=fX03-WEu_EI)

[Video: KYC 集成方式：跳转链接、iFrame 与原生 SDK 对比 - Didit Academy](https://www.youtube.com/watch?v=MxMFf43KONg)

使用 Didit 上线身份验证不需要开发人员。
有一个几分钟就能完成的无代码选项，也有 API 和 SDK 选项，供你把它自动集成到自己的产品中。

## 我可以不写代码就使用 Didit 吗？

可以。在控制台中[搭建工作流](https://help.didit.me/zh/workflows/build-a-verification-workflow)之后，你可以用两种零代码方式生成验证会话：

![Didit 控制台中的集成页面，展示从 API 密钥到首个会话的五步清单](https://help.didit.me/screenshots/integrate-light.webp)

*集成页面是从零到跑通一个会话最短的路径。*

1. **验证链接（一次性）**

   点击**新建验证**（位于首页、核验列表或某人的档案中），选择一个**工作流**，在**供应商数据**中填写你为此人设定的 ID，然后点击**创建验证**。接着通过电子邮件发送链接、复制链接或展示二维码。**单项检查**标签页可以单独运行一项检查（例如 AML 筛查），无需运行整个工作流。

2. **可复用链接（Unilink）**

   每个工作流都有一个可复用链接，每次访问都会开启一个全新的会话。
   你可以把它放在网站的按钮后面，打印成二维码用于自助终端或门店，或者分享给合作伙伴。
   参见[可复用链接](https://help.didit.me/zh/integration/reusable-links)。

这两种方式都完全跳过了 API 和你的后端，非常适合 MVP、人工审核、面对面验证，或是在你还没有搭建任何自定义系统之前先用起来。

## 当你需要自动化时

[Video: 通过 MCP 将 Didit 连接到 Claude - Didit Academy](https://www.youtube.com/watch?v=I3UkFIhW548&t=71)

如果你需要结果自动更新到你自己的系统里，而不只是显示在控制台中，那你需要 API 或 SDK：

| 你想要... | 使用 |
|---|---|
| 从你的应用把用户重定向到托管的验证页面 | 一次 API 调用创建会话，然后重定向到返回的 URL |
| 在你的 Web 应用中内嵌验证流程 | [JavaScript SDK](https://docs.didit.me/integration/web-sdks/javascript-sdk) 或[内嵌式 iframe](https://docs.didit.me/integration/web-sdks/incontext-iframe) |
| 在原生 iOS、Android、Flutter 或 React Native 应用中验证 | 对应的[原生 SDK](https://help.didit.me/zh/integration/mobile-sdks)，NFC 场景下是必需的 |
| 为 WordPress/WooCommerce 或 Shopify 添加验证 | [WordPress/WooCommerce](https://docs.didit.me/integration/web-sdks/wordpress-woocommerce) 或 [Shopify](https://docs.didit.me/integration/web-sdks/shopify) 插件，无需代码 |
| 接入自动化工具 | 通过 [Zapier](https://docs.didit.me/integration/engines/zapier)、n8n 或任何能发起 HTTP 请求并接收 webhook 的工具调用 API |
| 结果一就绪就推送到你的后端 | [webhook](https://help.didit.me/zh/integration/webhooks-basics) |
| 自行运行单项检查（批处理、自定义采集界面） | 直接调用独立 API，而不经过工作流会话 |

## 自己发送链接

如果你通过 API 创建会话，Didit 会返回验证 URL，之后由你负责投递。
从你自己的产品中发送，用你自己的文案和品牌风格，通常也是更好的体验：对方本来就信任你，而来自陌生发件人的消息会带来转化成本。

如果你需要 Didit 代为向用户发送邮件，请在创建会话时传入联系方式。
建议确认你的方案实际支持哪些功能，而不要凭假设，并注意**邮件语言是与流程语言分开的字段**。
参见[设置验证语言](https://help.didit.me/zh/workflows/verification-languages)。

## 在托管、内嵌和原生之间选择

| | 托管重定向 | 内嵌（Web SDK / iframe） | 原生 SDK |
|---|---|---|---|
| 所需代码量 | 最少 | 中等 | 最多 |
| 用户离开你的应用 | 是 | 否 | 否 |
| 读取 NFC 芯片 | 否 | 否 | **是** |
| 最佳摄像头表现 | 良好 | 良好 | 最佳 |
| 自定义域名从 URL 中移除 Didit | 是 | 不适用 | 不适用 |

如果 NFC 对你很重要，这一行就是决定因素：浏览器页面无法读取芯片。
参见 [NFC 芯片验证](https://help.didit.me/zh/documents-coverage/nfc-chip-verification)。

在围绕某个方案规划项目之前，值得向你的 Didit 联系人确认你的套餐支持哪些内嵌选项。

## 独立 API 与工作流会话

工作流会话会把各项检查一起运行，产出一个汇总决策，并且按每项已完成的功能计费。
独立 API 调用只对你提供的数据运行一项检查，只返回该项结果，并且是**按次计费**的，按其自身标价收费。

独立调用适合批处理、你自建的采集界面，或者是你想在入网流程之外单独运行的检查。
如果你想要的是整个流程的一个汇总决策，这就不是合适的工具。

## 上线前先测试

通过应用名称下的切换器进入 **Sandbox**，创建并使用测试 API 密钥。所有检查都被模拟，不收费，你可以指定结果。

[在沙盒中测试](https://help.didit.me/zh/getting-started/sandbox-and-testing)

## 下一步

- 如果还没搭建工作流，先完成这一步：[搭建验证工作流](https://help.didit.me/zh/workflows/build-a-verification-workflow)
- 结果一就绪就获取：[通过 webhook 获取验证结果](https://help.didit.me/zh/integration/webhooks-basics)
- 在哪里找到你的 API 密钥：[管理你的 API 密钥](https://help.didit.me/zh/account-organization/api-keys)
- 遇到错误时该怎么办：[API 错误及其含义](https://help.didit.me/zh/integration/api-errors)

## 连接 AI 工具

在**连接 AI 工具**中选择工具并遵循设置说明。授权连接时，选择目标组织并在批准前检查请求的权限。如果账户或组织不正确，请先切换，再授予访问权限。