Didit API 集成教程：SDK 与 Webhook

集成 Didit 到你的应用：API、SDK 与 Webhook（开发者指南） 的完整文字稿 - Didit Academy 第 8 讲（共 10 讲），时长 08:13。在 YouTube 上观看。每个段落都链接到视频中对应的具体时刻。

​

你将完成的对接

00:04 在本视频中，你将把 Didit 接入自己的应用。这样，用户可以直接在你的产品内完成验证，每个结果都会在产生的那一刻回传到你的系统。这是面向开发者的视频，所以技术性会强一些，但比你想象的简单。看完之后你会发现，大部分工作都可以直接交给 Claude Code，让它替你搭建。因此，我们会按照你实际搭建的顺序来讲

​

SDK, API 和 Webhook 的三个组成部分

00:28 你实际搭建的顺序。让我们直接开始。集成 Didit 需要完成三件事。SDK 在你的应用内直接渲染摄像头、证件采集、NFC 读取和活体检测界面。API 是服务器到服务器的调用，因此你的后端创建会话并读取权威决策。Webhook 则会在会话状态变化的瞬间调用你的 HTTPS endpoint，

​

集成标签页

00:56 速度比轮询快得多，内容也更丰富。因此，最简单的集成方式是进入 Manage 标签页，点击 Integrate，在这里获取所有设置，比如 API 密钥。我们可以为正在开发的这个应用单独设置一个专用的 API 密钥。我们可以创建并选择要集成的工作流。我们还可以添加一个 Webhook，这里就是验证结果推送到的地方。 01:24 稍后我会展示的签名密钥，就是要

​

选择您的平台

01:28 放入你的 ENV 文件中。然后你就可以把它连接到应用。这里提供了几种不同的选项：Web JS、React Native、iOS、Android、Flutter，以及其他几种平台。选择与你的应用相关的那一个即可。这些是环境密钥，你需要把它们放进

​

AI 设置提示词

01:48 服务器上的 ENV 文件中。最简单的方法是使用 AI 设置提示词。我们先在这里配置好所有设置，然后复制提示词，它会自动带上我们在这里完成的设置中所有需要的信息。复制并粘贴到 Claude Code、Codex 或其他你用来构建应用的工具中。

​

每个环境一个 API 密钥

02:09 你的 API 密钥保存在这里，每一行就是一个密钥，对吧？因此，一个好习惯是为每个环境、每个集成分别使用一个密钥。这样你可以轮换或撤销其中一个，而不会影响其他密钥。所以，如果你要集成某个特定工作流，你

​

创建密钥

02:27 可能会想为该工作流单独准备一个 API 密钥。现在，如果我点击“创建 API 密钥”，嗯，我就把它命名为 test，然后创建 API 密钥。接着我可以复制它，对吧？而且之后不会再次显示。所以，务必复制下来并记在某处，以便集成时使用。进入集成部分，获取 API 密钥时，比如我选择 test 密钥并往下看，选择这个，好的，我们想用这个……嗯，让我看看，KYC 工作流。我们可以添加一个 Webhook。 03:05 我们可以连接应用，好的。然后把这个设置提示词粘贴到这里。你可以看到，这个提示词会

​

Webhook 概览

03:13 包含 API 密钥。接下来简单看一下 Webhook，我们几乎可以为任何想要的内容设置 Webhook。比如，如果你想把某个特定事件发送到 Slack，对吧？我们可以

​

文档

03:25 在这里添加 Webhook URL。好的，我们来看一下文档，因为你确实可以访问全部技术文档。只要访问 docs.didit.me，我们来看其中的几处内容

​

创建会话的唯一必填字段

03:37 这里。一切都围绕着创建会话展开。好，这是一个 POST 请求，是验证的起点。我们可以在这个 curl 请求中看到，它包含工作流 ID。这是唯一的必填字段，而且非常实用的一点是，同一个 endpoint 既能创建 KYC 会话，也能创建 KYB 会话。具体是哪种会话

​

供应商数据与回调 URL

04:00 由工作流决定。下面还有一些其他字段，包括供应商数据，我们在这些视频中已经多次提到。它是每个用户的唯一标识，你可以按自己的需要定义，比如邮箱或其他唯一标识。另外，这里有回调 URL，它是用户完成验证工作流后被跳转到的地址。所以，

​

实际调用 endpoint

04:24 如果往下滚动，我们其实可以直接试一下。点击“Try it”，就能在这里创建一个验证会话。我先在这里填入一个 API 密钥，再创建一个全新的，命名为 test two。复制它，粘贴到这里。我们需要获取一个工作流 ID，切换到这里，就能拿到这个工作流 ID，然后输入到那里。供应商数据不是必填的。我们随便填一串随机数字。 05:02 回调地址这里可以保持不变。顺便说一下，这些都不是必填项。我想这是因为我这里用的是测试账户，但如果你想测试这个 endpoint，就是这样测试的。现在，如果你是开发者，想要更具体的答案，可以查阅文档。MCP 也能访问全部这些文档，所以你完全可以直接集成 MCP，然后向 Claude 提出你可能有的技术问题，而这些答案很可能就在这些文档里

​

Webhook 为何不用轮询

05:32 就在这里面。接下来说说 Webhook。管理板块里有 Webhook 标签页，结果正是通过它送达你的。Webhook 是推荐的方式，因为轮询相当慢，而且它

​

添加目标并选择事件

05:44 会让你多消耗请求，还会漏掉事件。所以我们在这里添加一个新的目标。可以粘贴一个 URL，也可以选择想要的事件。这就是我们希望发送到这个特定 endpoint 的全部数据。Didit 会返回一个一次性签名密钥，稍后我会给你看。这个 URL 必须可以直接访问，因此不能是 localhost，也不能是私有地址。好，我先退出这里，然后滚动到右侧，这里有几个选项。 06:16 这里可以看到此 Webhook 正在监听的事件数量，我们还可以

​

签名密钥

06:19 复制签名密钥，这对你的集成很重要。当我们在集成标签页里做集成设置时（我之前带你走过那一步），里面有一个提示词，签名密钥会显示在你在设置中选定的那个 Webhook 下面。所以

​

Webhook 处理程序提示词

06:34 这是 AI 的另一种用法。我在 Webhook 标签页里找到了一个现成的提示词。如果你想用 AI 来设置 Webhook 处理程序，可以查看文档，在那里找到集成提示词。它涵盖身份验证、实体和交易，会替你把整套内容搭建出来。它会把一切都列清楚：要构建什么、验证用的签名头、你刚才设置 Webhook 时看到的 Webhook 事件类型、Webhook 信封，以及很多其他内容。你还可以选择把它粘贴到你正在使用的工具中。 07:15 所以，如果你想使用这个提示词，它就是快速上手并完成集成设置的简便方法。如果你接入了 MCP 服务器，本视频中我刚讲的所有内容，都可以在你的 AI 工具中访问和查询。你只需用平实的语言说明想要什么，Cloud Code 就会读取文档并为你构建集成。你要做的只是检查成果，确保它能运行，并且

​

小结

07:41 正在工作，而不是从头手写全部代码。这就是 Didit 在你应用中的样子：用户看到的是 SDK，你的后端调用的是 API，而已签名的 Webhook 会送达你据以构建的判定结果。信任 Webhook，处处使用供应商数据，并借助设置提示词，这样你就不必手动编写那些繁琐的部分。你可以前往 didit.me 免费注册，几分钟内就能跑通一次验证。