常见问题 FAQ
下面是开发者接入 A7验证时的高频问题。问题答案同时以结构化数据（FAQPage JSON-LD）输出，便于搜索引擎收录。
A7验证的接口地址是什么？
Init 与 Handle 都是 POST https://api.a7p.cn/api/verify。Init 用表单字段提交 AppId / AppKey 换取 ApiPassword；Handle 通过 X-Api-Password 请求头或 URL 路径 /api/verify/{ApiPassword} 传递 ApiPassword，提交加密后的 Data 与签名。详见 API 概述 · 两步模型。
后端一共有哪些 action？
共 12 个真实 action：SingleLogin、UserLogin、UserRegin、UpdatePwd、ChangeBind、UserHeartbeat、GetLatestVersion、GetBulletin、GetVariable、GetUserInfo、GetCardInfo、UserRecharge。不存在 webhook、unbind、init（作为 action）等端点，传入会返回 1015 未知操作。
调用返回 1010 签名错误怎么办？
先确认两条公式：
- Init 签名 =
MD5(AppId + AppKey + TimeStamp + AppKey) - Handle 签名 =
MD5(ApiPassword + TimeStamp + Data)
注意 MD5 用小写 32 位，Data 是 RC4 密文转 HEX，时间戳为秒级且偏差需在 ±300 秒内。逐字段对照 签名校验与 RC4 加密 的自查清单。
卡密模式和用户模式有什么区别？
- 卡密模式：
SingleLogin（卡密 + 机器码），按次卡每次登录扣次数，时长卡按到期时间。 - 用户模式：
UserRegin注册、UserLogin登录，账号可绑定设备、可换绑、可充值续期。
只有 SingleLogin 与 UserLogin 计入后台验证统计。
心跳必须每 5 分钟一次吗？
推荐每 5 分钟调用一次 UserHeartbeat，Type 与登录类型一致（card / user）。服务端会在略大于周期的时间判定离线，并有短暂容错宽限。心跳还负责接收后台下发的阅后即焚消息。详见 心跳保活机制。
换电脑登录提示 1022 怎么处理？
1022 表示机器码已变更。
- 账号模式：调用
ChangeBind校验密码后换成新机器码（受bind_times次数限制）。 - 卡密模式：直接用卡密在新设备重新
SingleLogin即可，卡密不与设备强绑定。
按次卡为什么不能用于用户续期？
按次卡按次数计费，设计上只支持卡密登录（SingleLogin）逐次扣减。用于用户续期（UserRecharge）或注册激活（UserRegin）会返回 1024，请改用时长卡密。
ApiPassword 需要保存到哪里？
ApiPassword 仅在内存保存，每次启动重新 Init 获取即可，切勿硬编码、明文落盘或写入配置文件。AppKey 也只出现在 Init 阶段，业务流量中不应包含。