开发文档 · APIRote

快速开始

从注册到完成第一次调用

01 register

注册开发者账号并登录控制台。（当前站点已关闭自助注册）

02 app

控制台「我的应用」创建应用，系统会自动生成默认应用，也可按需新建。

03 key

在应用下创建密钥得到 AK 与 SK；SK 明文仅展示一次，请立即保存。

04 invoke

在「接口中心」订阅接口后，携带请求头访问 /gateway.php/{接口路径}。

模式	开关（应用维度）	必带请求头	适用场景
签名模式默认、推荐	`sign_required = 1`	`X-App-Key` / `X-Timestamp` / `X-Nonce` / `X-Sign`	服务端、公网、生产环境，可防篡改与重放
免签名模式	`sign_required = 0`	`X-App-Key`	内网或无法计算 HMAC 的环境；AK 等同口令，务必配置 IP 白名单

~/examples/curl.sh

签名算法：X-Sign = HMAC_SHA256(大写METHOD \n PATH \n TIMESTAMP \n NONCE \n SHA1(BODY), SK)，小写 hex

PATH 含前导斜杠且不含 gateway.php 与 query；时间戳为秒级，默认允许偏差 300 秒；nonce 不可重复。

接口中心标注「免费」的接口已开放游客调用：无需 AK 与签名，直接请求即可，按来源 IP 限流（2 次/秒、200 次/日）。标注「限免」的接口在限免期内免订阅、不计费，但仍需携带密钥调用。