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

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

Short answer

共有三种途径。 无代码链接完全不需要后端。 API 加上重定向是标准的集成方式。 SDK 把整个流程嵌入你自己的应用中,也是唯一支持 NFC 的方式。 无论你选择哪种,都通过 webhook 获取结果。

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

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

可以。在控制台中搭建工作流之后,你可以用两种零代码方式生成验证会话:

Didit 控制台中的集成页面,展示从 API 密钥到首个会话的五步清单
  1. 第一步签发你后端用于认证的 API 密钥。
  2. 第二步选择每个会话要运行的工作流。
  3. 第三步注册结果的投递地址,并发送一次测试投递。
  4. 第四步是代码:复制适合你技术栈的快速上手示例。
集成页面是从零到跑通一个会话最短的路径。
  1. 验证链接(一次性)

    工作流页面,直接在控制台中创建一个会话。 你会得到一个专属于这个人的唯一 URL 和二维码,可以通过邮件、短信或任何渠道发送,或者让对方当面扫码。

  2. 可复用链接(Unilink)

    每个工作流都有一个可复用链接,每次访问都会开启一个全新的会话。 你可以把它放在网站的按钮后面,打印成二维码用于自助终端或门店,或者分享给合作伙伴。 参见可复用链接

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

#当你需要自动化时

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

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

#自己发送链接

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

如果你需要 Didit 代为向用户发送邮件,请在创建会话时传入联系方式。 建议确认你的方案实际支持哪些功能,而不要凭假设,并注意邮件语言是与流程语言分开的字段。 参见设置验证语言

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

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

如果 NFC 对你很重要,这一行就是决定因素:浏览器页面无法读取芯片。 参见 NFC 芯片验证

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

#独立 API 与工作流会话

工作流会话会把各项检查一起运行,产出一个汇总决策,并且在四项免费功能上享受各自的免费额度。 独立 API 调用只对你提供的数据运行一项检查,只返回该项结果,并且是按次计费、没有免费额度的。

独立调用适合批处理、你自建的采集界面,或者是你想在入网流程之外单独运行的检查。 如果你想要的是免费额度,这就不是合适的工具。

#上线前先测试

为测试创建一个独立的沙盒模式应用:每个应用都有各自的 API 密钥和工作流,因此测试流量不会触碰正式数据,沙盒会话不产生费用,还能让你强制得到任意结果。 参见在沙盒中测试

#下一步