跳到主要内容

通用

MP API系统目前仅支持订单、流量和警报等功能。

API请求

在所有API中,以下是常见的请求头及其描述:

名称类型是否必须描述
Access-keystringtrueaccessKey 为客户端应用身份,跟 secretKey 配套
Content-Typestringtrueapplication/json

生成签名

  1. 签名算法(sign)
名称类型是否必须描述
timestampLongtrue当前时间戳,10位数字
dataObjecttrue参数
  1. 规则:
  • 对数组的值按key排序 请求示例:
{"data": {"page": "1","limit": "10"},"timestamp": 1752833996}
  • 生成url的形式
data%5Bpage%5D=1&data%5Blimit%5D=10&timestamp=1752833996
  • MD5算法加密生成sign: 字符串+私钥拼接
sign = md5('data%5Bpage%5D=1&data%5Blimit%5D=10&timestamp=1752833996' + secret_key)

请求示例

{
"timestamp": 1752833996,
"data": {
"page": 1,
"limit": 10
},
"sign": "df0a31b6c4b5810c2d8e318247a9ad4f"
}

API响应响应通常遵循以下格式:

{
"code": 200,
"msg": "string",
"data": {}
}
名称类型是否必须描述
codeinttrue响应码200表示成功
msgstringtrue响应消息
datajson or nulltrue响应数据

响应验证签名

响应的请求头返回签名计算所需的参数。具体步骤请参考:


HTTP code

名称描述
200成功
401认证失败
403拒绝访问
404未找到

Business code

名称描述
500服务异常
60001参数缺失
60002非法参数
60003数据不存在