注册与创建产品
本页介绍如何在 A7验证(A7Verify)开通开发者账号并创建你的第一个程序。完成本页后,你会得到接入 API 所需要的两个凭据:AppId 与 AppKey。
调用步骤
- 打开 A7验证主站 注册开发者账号。
- 登录开发者控制台。
- 在「我的程序」中新建一个程序(产品),填写程序名称、版本号等信息。
- 等待程序审核通过(
status = approved)。 - 在「API 信息」页复制
AppId与AppKey。 - 按 5 分钟接入示例 跑通第一次调用。
一、注册开发者账号
访问 https://www.a7p.cn/ 完成注册。A7验证按角色区分了三个登录入口:
| 角色 | 入口 | 用途 |
|---|---|---|
| 开发者 | dev.a7p.cn/login-dev.html | 创建程序、生成卡密、查看验证日志 |
| 代理 | dev.a7p.cn/login-agent.html | 分销后台,批量取卡 |
| 管理员 | dev.a7p.cn/login-super.html | 平台总后台 |
接入 API 请使用开发者入口。
二、创建程序(产品)
在开发者控制台新建程序时需要填写:
| 字段 | 说明 |
|---|---|
| 程序名称 | 你的软件名称,会在 GetVariable 的 app_name 中返回 |
| 版本号 | 当前版本,会在 GetLatestVersion 的 version 中返回 |
| 版本名称 | 例如"新春特别版",对应 version_name |
| 更新内容 | 对应 version_data,客户端可直接展示为更新日志 |
| 下载地址 | 对应 download_url,用于客户端自动更新 |
| 程序公告 | 对应 GetBulletin 返回的 content |
创建成功后系统会为该程序自动生成三样东西:
AppId:程序编号,例如150018AppKey:程序密钥(32 位大写字母 + 数字),用于 Init 握手签名ApiPassword:接口密码,由 Init 接口下发给客户端,不需要你手工分发
三、程序审核状态
程序必须处于「已审核通过」状态才能调用 API。
| 状态 | 说明 | 调用 API 的结果 |
|---|---|---|
| 审核中 | 新建程序的默认状态 | 返回 1012 程序未审核通过 |
已审核通过(approved) | 正常可用 | 正常返回业务数据 |
| 套餐已过期 | 开发者套餐到期 | 返回 1012 程序套餐已过期,请联系开发者续费 |
提示
1012 与凭据无关,检查凭据前先确认程序状态。详见错误码对照表。
四、准备验证模式
A7验证支持两种主流验证模式,创建程序时可以先想清楚要用哪种(也可以同时用):
卡密模式(Card)
用户拿到一串卡密(例如 UTDE-7TCX-N5AT-ZDSP),软件里输入卡密即可使用,卡密自动绑定当前机器码。
- 主接口:
SingleLogin - 适合:一次性售卖、按次计费、不想让用户注册账号的场景
- 支持按次卡(
is_times = true,有total/used/remaining)
用户账号模式(User)
用户注册用户名 + 密码,卡密用来给账号充值续期。
- 主接口:
UserRegin→UserLogin→UserRecharge - 适合:需要长期运营、多设备、需要找回账号的场景
- 支持 QQ 扫码登录(
LoginType=qq)
两种模式的心跳都走 UserHeartbeat,只是 Type 分别传 card 与 user。
五、可选的风控配置
在程序设置中可以开启以下限制,触发时 API 会返回对应错误码:
| 配置项 | 触发错误码 | 说明 |
|---|---|---|
| 每 IP 最大注册数 | 1019 | 防止刷号 |
| 换绑次数限制 | 1021 | 限制用户更换设备的次数 |
| IP / 机器码黑名单 | 1023 | 直接拉黑指定 IP 或机器码 |