一、接口地址
线上环境地址:https://api.jxctmall.com
测试环境地址:https://api.jxctmall.com/test
二、http请求头
在调用每个开放平台的接口时,须在http请求头携带以下固定头,并设置相关值。
请求头 | 说明 |
---|---|
X-AK | 开放平台的Appkey,联系商务获取,同时也会提供AppSecret用于签名秘钥参与签名验证 |
X-SIGN | 接口请求的签名,用于防篡改,具体实现可参考签名算法中描述 |
X-TS | js时间戳,开放平台会对时间戳超过5分钟的请求进行屏蔽过滤 |
X-NONCE | 随机数,至少6位以上 |
三、接口返回数据结构
开放平台接口返回的数据结构为固定通用的,且为json格式,具体格式如下:
请求头 | 说明 |
---|---|
success | 接口是否执行成功,true:成功 false: 失败 |
code | 接口返回的具体业务代码,当为 “00000” 时表明接口调用成功,否则调用失败,code会根据业务不同返回不同值 |
message | 接口调用返回提示信息 |
data | 接口调用返回的具体结果对象,一般为json格式的java对象 |
示例:
{
"success": false,
"code": "81028",
"message": "签名错误",
"data": null
}