Checkify
JavaScript SDK — 生产就绪

构建检查 进入您自己的应用程序或网站。

每个站点一张 Checkify Pass。当用户开始验证时,您的页面会选择证明——人类、18 岁或 25 岁。放入嵌入片段并在服务器上验证结果。

快速入门
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>

在业务仪表板中创建一个数字网站,复制您的通行证 ID,注册将运行嵌入的域,然后粘贴下面的代码片段。可选的 DNS、元标记或文件验证可加强站点/域名验证,但嵌入工作并不是必需的。

需要帮助吗?登录后发送电子邮件至 support@checkify.me 或打开 Checkify Passes 选项卡,复制您的 Pass ID 和集成片段。

整合流程
站点→通行证→SDK→服务器验证
居住
开发者流程
创建数字网站 居住
复制通行证 ID 居住
添加SDK嵌入 居住
在您的后端验证 居住
1
创建站点
2
添加SDK
3
核实
嵌入
SDK直播
核实
API 直播
概述

每个站点一张通行证。您页面上的请求类型。

当您创建数字站点时,Checkify 会自动配置一个可重复使用的通行证 ID。您在该网站的任何地方(结帐、登录、注册)都保留相同的通行证 ID,并在需要每个证明的地方设置 data-checkify-request。没有执行表单启动器设置。

1

JavaScript 嵌入

自动安装小部件或 bindForm 用于登录、注册、结账和联系表单。 SDK 处理按钮、隐藏的 checkify_token 字段和提交状态。

现已上市
2

服务器验证

使用您的站点 API 密钥和隐藏字段中的 request_id 调用 POST /v1/qr/results/verify。切勿仅信任浏览器 - 在注册、结帐或密码重置之前进行验证。

现已上市
3

WordPress 和 WooCommerce

安装 Checkify 插件,粘贴您的 Pass ID,然后在您保护的页面上选择人员或年龄检查。与自定义站点相同的一次性模型。

现已上市
一次通过模型

Checkify 通行证如今的运作方式

站点、通行证和证明请求是单独的层。这使得 WordPress 插件、WooCommerce 和自定义网站变得简单:复制一个 ID,在多个地方使用它。

1

1. 创建站点

注册您的企业、添加数字网站并列出允许的域(例如 example.com 和 www.example.com)。每个站点都会获得一张 Checkify Pass。

2

2. 复制一份通行证 ID

在业务仪表板中的 Checkify Passes 或 Developer 下找到您的 Pass ID。在您的网站、插件或后端集成中使用相同的 ID — 当您切换证明类型时,它不会改变。

3

3. 在代码中选择请求类型

在每次嵌入或 bindForm 调用时将 data-checkify-request 设置为人类、age_over_18 或 age_over_25。人工检查通常是免费的;年龄检查获得批准后会消耗积分。

请求类型

数据检查请求 典型用途
人类 验证码替换、机器人减少、无摩擦人工检查
年龄超过18岁 18 岁以上结帐、受限内容、年龄限制注册
年龄超过25岁 挑战25,年龄门槛更高
有什么可用

集成选项

JavaScript 嵌入和服务器验证端点已投入生产。使用业务仪表板创建站点、复制通行证 ID 并颁发站点 API 密钥。

移动应用程序移交和 npm 打包已列入路线图。如今,网站集成所需的一切都可以通过 CDN 脚本和 REST 验证 API 来实现。

今日上市

JS
JavaScript 网络 SDK
适用于网站、表单、结账和自定义流程的 CDN 脚本。每个嵌入的通行证 ID + 请求类型。
现已上市
API
服务器验证API
POST /v1/qr/results/verify 授权:持有者 YOUR_SITE_API_KEY。开发人员指南中的文档和代码示例。
现已上市
App
移动应用程序集成
通过 QR 或深层链接从本机应用程序启动 Checkify。指南和 SDK 打包即将推出。
即将推出

旧版启动器 ID 已弃用。对所有新集成使用通行证 ID + 请求类型。

它是如何运作的

端到端集成

从网站设置到后端验证用户的四个步骤。 Pass ID 保持不变;每个用例仅请求类型和服务器验证声明发生变化。

步骤1

创建网站并复制您的 Pass ID

登录到业务仪表板,打开站点,然后使用您允许的域创建数字站点。 Checkify 自动创建一张通行证。打开 Checkify Passes 复制 Pass ID (chk_live_…) 或获取现成的代码片段。

一张通行证,多种用途

登录(人)、结帐(age_over_18)和仅限员工的页面(人)上的通行证 ID 相同 - 每次嵌入仅更改 data-checkify-request。

现已推出:仪表板中的站点 + Checkify Passes
创建站点并复制 Checkify Pass ID

步骤2

将嵌入添加到您的页面

从 checkify.me 加载 SDK 并安装 Pass 小部件,或使用 Checkify.bindForm 作为表单。替换 YOUR_PASS_ID 并设置该页面或操作的请求类型。

最小嵌入
<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div data-checkify-pass="chk_live_YOUR_PASS_ID" data-checkify-request="human"></div>
现已推出:JavaScript 嵌入 + bindForm

表单绑定示例

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>

<div
  data-checkify-pass="chk_live_YOUR_PASS_ID"
  data-checkify-request="age_over_18"
  data-checkify-text="Verify with Checkify"
></div>

请参阅 嵌入 API 参考 用于configure()、事件和返回URL 处理。

步骤3

用户完成验证

当用户点击“验证”时,Checkify 将打开证明流程(在浏览器中或通过移动设备上的 Checkify 应用程序)。成功后,SDK 会将 request_id 写入隐藏的 checkify_token 字段,以便后端可以验证它。

✓ 该网站上每种证明类型的通行证 ID 相同。
✓ 人类、18 岁和 25 岁是在 HTML 或 bindForm 选项中选择的,而不是在“通行证”设置中选择的。
✓ 域必须与站点的允许域列表相匹配。
现已推出:通行证启动+应用程序切换

启动选项

内嵌按钮
在您的页面上嵌入小部件或 bindForm。
二维码/魔术链接
通过仪表板的物理位置和面对面流程。
移动切换
用户在 Checkify 应用程序中完成证明并返回到您的网站。

步骤4

在您的服务器上验证

从表单 POST 中读取 request_id,然后使用您的站点 API 密钥调用验证端点。在允许受保护的操作之前检查已批准的声明(human_verified、age_over_18 等)。

验证请求(服务器)
POST https://checkify.me/v1/qr/results/verify
Authorization: Bearer YOUR_SITE_API_KEY

{
  "request_id": "uuid-from-checkify_token-field",
  "required_claims": ["human_verified"],
  "consume": true
}
现已上市:POST /v1/qr/results/verify

验证成功后

前端
仅在服务器确认验证后才启用提交、继续结账或显示成功。
后端
使用 required_claims 和 consume: true 进行一次性操作,例如注册或密码重置。
您的政策
允许结帐、解锁内容、创建帐户或根据已批准的声明批准员工操作。

网站生产就绪

创建一个站点,复制一个 Pass ID,嵌入 SDK,并使用站点 API 密钥进行验证。 WordPress 和 WooCommerce 使用相同的模型。

立即使用

JavaScript 嵌入、bindForm、服务器验证 API、站点 API 密钥、WordPress 插件、业务仪表板。

路线图

npm 包、webhooks、签名的 webhook 交付、本机移动 SDK 指南。

开始整合

在业务仪表板中创建您的网站,复制您的 Pass ID,然后按照开发人员快速入门进行操作。 WordPress 网站可以使用具有相同 Pass ID 的插件。