Skip to main content

general

The MP API system currently only supports functions such as orders, traffic, and alerts.

API request

Among all APIs, the following are common request headers and their descriptions:

NameTypeRequiredDescription
Access-keystringtrueaccessKey serves as the identity of the client application, and it is paired with secretKey
Content-Typestringtrueapplication/json

generate signature

  1. Signature algorithm(sign)
NameTypeRequiredDescription
timestampLongtrue当前时间戳,10位数字
dataObjecttrue参数
  1. Rules:
  • Sort the values of the array by key Request example:
{"data": {"page": "1","limit": "10"},"timestamp": 1752833996}
  • Generate the format of the URL
data%5Bpage%5D=1&data%5Blimit%5D=10&timestamp=1752833996
  • MD5 algorithm is used to encrypt and generate the sign: a concatenation of the string and the private key
sign = md5('data%5Bpage%5D=1&data%5Blimit%5D=10&timestamp=1752833996' + secret_key)

Request Example

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

API responses typically follow the following format:

{
"code": 200,
"msg": "string",
"data": {}
}
NameTypeRequiredDescription
codeinttrueThe response code 200 indicates success
msgstringtrueresponse message
datajson or nulltrueresponse data

Response verification signature

The response header returns the parameters required for signature calculation. For specific steps, please refer to:


HTTP code

NameDescription
200Success
401Authentication failed
403Access denied
404Not found

Business code

NameDescription
500Service exception
60001Missing parameter
60002Illegal parameter
60003Data does not exist