调用说明

所有 API 调用需遵循以下规则：

请求方式

所有接口均使用 POST 方式请求，数据格式为 application/x-www-form-urlencoded。

公共参数

每次请求必须包含以下公共参数：

签名规则

部分接口需要签名验证，签名生成规则如下：

1. 将所有请求参数按参数名升序排序
2. 拼接成 key=value&key=value 格式的字符串
3. 在字符串末尾拼接商户密钥
4. 计算 MD5 值作为签名

签名示例

// 原始参数
account=merchant123
api_code=AG
username=test001

// 排序后拼接
account=merchant123&api_code=AG&username=test001

// 拼接密钥
account=merchant123&api_code=AG&username=test001&key=abc123

// 计算MD5
sign = md5("account=merchant123&api_code=AG&username=test001&key=abc123")

响应格式

所有接口返回 JSON 格式数据：

{
  "Code": 0,        // 返回码
  "Message": "成功", // 返回说明
  "Data": {}        // 返回数据
}

注意事项

• 请求频率限制：每个商户每秒最多 10 次请求
• IP 白名单：请将服务器 IP 添加到白名单
• 超时时间：接口超时时间为 30 秒
• 编码格式：所有参数使用 UTF-8 编码