外观
历史兼容接口总览
本页用于维护已有客户端。新项目优先使用 HTTP V3 或官方 SDK,不要为了代码更短主动选择旧协议。
传统公开入口
| 路由 | 用途 | 说明 |
|---|---|---|
POST /api/verify | 域名或授权验证 | 新写操作只允许 POST |
POST /api/kmlogon | 历史卡密登录 | 对应 card_login/kmlogon 权限 |
POST /api/kmunmachine | 历史卡密解绑 | 对应 card_unbind/unbind_machine 权限 |
POST /api/check | 传统状态验证 | 不代替 SDK 心跳 |
GET/POST /api/paycheck | 支付/授权检查兼容 | 仅已有业务继续使用 |
POST /api/app | Legacy V1 聚合入口 | 通过 api 参数选择子动作 |
POST /api/card_login | Legacy V1 卡密登录 | MD5 参数签名,仅旧项目 |
POST /api/unbind_machine | Legacy V1 解绑 | 遵循项目解绑规则 |
GET/POST /api/announcement | 旧公告入口 | 只返回当前程序公告 |
GET/POST /api/latest_version | 旧版本检查 | 新 SDK 使用 /api/v1/apps/version |
POST /api/app-users/register | 兼容程序用户注册 | 项目内账号,不是平台账号 |
POST /api/app-users/login | 兼容程序用户登录 | 不创建 SDK v1 会话时使用 |
GET /api/download/{id} | 文件下载 | 必须使用服务端签发的有效地址 |
Legacy V1 聚合动作
/api/legacy/v1/app 与旧 /api/app 只用于历史客户端,支持的规范动作包括:card_login、card_unbind、user_login、user_register、announcement、app_config、get_file 和 app_profile。旧别名仍用于已有项目配额兼容,但新代码应使用规范动作名。
授权文件核心验证
历史授权文件 core 是可按项目单独开通的旧版域名授权验证接口,不属于基础 API 包,也不单独计算项目接口次数。它仍强制检查平台接口状态、项目与作者状态、验证总开关、授权站点、域名/IP 黑名单、IP 绑定以及作者每日 API/验证额度。兼容入口不会因为关闭旧动态接口的次数计量而绕过接口开通。详见 旧版域名授权验证。
Connect
POST /connect/{程序ID} 是独立配置、无 V1/V3 签名的兼容协议;开放方式由平台接口策略决定,历史拼写 /conncet/{程序ID} 只用于旧客户端。详见 Connect 单码登录。
不要混用成功规则
Legacy V1 的部分动作使用 code === 1 表示成功,标准 HTTP V3 通常使用 code === 0,Connect 使用 status === true,SDK 使用 Result.success。必须按当前协议判断,不能写一个通用数字规则套全部接口。