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