Sandbox
用于身份验证的 Sandbox API 密钥。
sandbox 密钥运行的 API、托管页面和 webhook 流程与生产环境完全相同，且使用永不计费的密钥。在洽谈价格之前，这是了解 ShieldID 是否适合您的最快方式。
工作原理
相同的流程。不同的密钥。没有账单。
Sandbox 不是简化的演示模式——它就是真实的验证流程，仅由您发送的密钥来区分。
| 密钥前缀 | vk_sand_… 会在您进行身份认证时标识出 sandbox 密钥。无需另行配置单独的 sandbox 账户或控制台。 |
|---|---|
| 环境标记 | 使用 sandbox 密钥创建的每个会话、结果和 webhook 都带有 environment: "sandbox",因此下游不会将任何 sandbox 创建的内容误认为真实验证。 |
| 计费 | 在所有套餐中，sandbox 会话均不计费，您可以创建任意数量的会话来构建和测试集成。 |
| 验证本身 | 真实：您自己的证件、您自己的脸、同样的检查。没有另外的一套虚假测试证件——您需要验证自己，来了解产品的实际表现。 |
获取密钥
今天即可申请。自助获取即将推出。
符合条件的套餐上的自助 sandbox 密钥创建已列入计划，但尚未确定时间。在其上线之前，通过联系表单提交申请即可直接获得密钥。
即将推出
即将推出符合条件的套餐上的自助 sandbox 密钥创建已列入计划，但尚未确定时间,让您注册后即可立即生成密钥。
亲自试一试
您可以在自己手机上运行的测试场景。
无需虚假证件——使用您自己的身份证件运行这些场景，即可了解每条路径的实际表现。
顺利通过
创建会话，打开托管页面，拍摄您自己的身份证件并完成活体检测挑战。观察 checks.document、checks.liveness、checks.antispoof 和 checks.face_match 全部返回 PASS。
拒绝相机权限
在托管页面请求时拒绝相机权限。会话将以 FAILED 结束，并带有 failure_reason,您可以据此构建真实的错误提示。
失败后重试(即将推出)
重新打开 FAILED 会话的 verification_url 以将其重置为 PENDING、进行第二次尝试的功能尚未上线。目前，请将 FAILED 视为最终状态——如果申请人想再试一次，请创建新的会话。
已过期的会话
创建一个会话后不做任何操作。超过默认时限后，它会变为 EXPIRED,且没有人员或检查数据——这是测试您界面超时提示信息的理想状态。
已取消的会话
对一个 PENDING 会话调用 DELETE /v1/sessions/{id}，然后尝试打开 verification_url。确认您的应用把已取消的会话视为已结束，而不是错误。
法语区域设置
使用 locale: "fr" 创建会话，并确认托管页面以及您自己的 return-URL 处理对法语申请人而言显示正确。
限制
Sandbox 不能做什么。
直截了当的回答，没有隐藏条款。
- Sandbox 没有与生产环境不同的单独速率限制——目前没有任何请求会受到套餐级别限制的节流，该限制机制尚未上线。
- Sandbox 与生产环境仅通过密钥前缀区分，而不是通过单独的账户、控制台或证件集合。
- sandbox 会话是对真实证件的真实验证。请勿使用他人的身份证件进行测试——请验证您自己的证件。
常见问题