API请求鉴权

API请求鉴权主要是认证调用方应用权限,不针对用户权限。主要通过应用的API_TOKEN和API_SECRET进行一定的算法签名来校验。

1. 接口调用权限开通

向平台申请开通接口调用权限,获取 API_TOKEN 和 API_SECRET。API_TOKEN 和 API_SECRET是应用唯一标识,请妥善保存,请勿泄露。

2. 接口校验方式

在HTTP请求Header中添加下面属性:

属性 说明
access-token API_SECRET的值。

3. 签名算法:

部分接口sign签名算法为:

以 API_SECRET 为密钥,用 md5 对参数+API_SECRET进行加密

java签名示例:

String resultString = new String( code + secret);
MessageDigest md = MessageDigest.getInstance("MD5");
resultString = byteArrayToHexString(md.digest(resultString.getBytes("UTF-8")));

4. 调用频次

用来生成 API_TOKEN 的同一个时间戳最多使用 当前账户限制最大并发数 次,否则会返回 PIN已被使用 错误。

若当前账户限制每秒并发数为5,则同一个时间戳可以使用5次,客户端可以多台机器并发调用

5. 错误代码对照表

code 说明
500 服务器错误
文档更新时间: 2025-07-25 15:12   作者:胡进