← 申请客户试点

客户试点接入指南

先确定想要的结果

号码基础检查回答号码格式与有效性；不回答本人是否持有。身份入驻提供托管证件、活体、人脸匹配及供应商决策；业务是否放行由你的系统决定。

申请、审批、接入

  1. 注册商户账号并验证邮箱，在申请页选择任务、国家和实际所需能力。
  2. 等待负责人确认用途、供应商条件、协议及免费额度。提交申请不会开通或扣费。
  3. 批准后，在商户控制台创建读写 API Key。先读取 capabilities，只有 available 为 true 的能力才能发起。
  4. 为每次业务请求生成请求 UUID 和同意引用 UUID。先取得本人同意；重试复用同一请求 UUID 和参数。
  5. 号码检查直接读取结果。身份核验把托管链接交给本人完成，随后读取或补查已有记录，不能凭回跳页面放行。

API 与 MCP

API 基础路径：https://gridzen.ai/console/api/production。商户密钥使用 Bearer 认证，供应商密钥始终保留在服务端。

GET /capabilities
POST /verifications
GET /verifications/{id}
POST /verifications/{id}/refresh

Agent 使用独立生产试点 MCP；公开研究 MCP 与离线 Skill 仍只提供研究和原型。

下载生产试点 MCP 客户端
python3 -m venv .venv
.venv/bin/python -m pip install mcp==2.3.0 httpx==0.28.1
# 在本机 MCP 配置中设置 GRIDZEN_API_KEY
# 启动命令：.venv/bin/python production_mcp.py

遇到问题怎么办

401：检查密钥和邮箱验证；403：检查生产审批或读写权限；409：检查请求 UUID 参数是否改变；429：等待或检查试点次数；503：能力、免费额度或有效期未满足。创建超时先读取原记录，不生成新请求重复核验。

completed 只表示已有最终供应商结果，仍需检查 provider_result.status。Approved、Declined、In Review 分别处理；不把未知、超时或未完成当作通过或欺诈。

查看试点条款 · 查看真实核验