接口输入数据格式

开放平台接口输入数据为JSON格式,并非类似于表单提交或者url的健值对形式。输入数据分为统一的header部分和requestBizData业务数据部分,见以下库存价格接口请求数据示例:

{

 "header": {
    "appKey": "10000003",
    "bizSource": "TEST",
    "sign": "f86faee880f822bd1329bf7c0dcf4f4c",
   "timestamp": "2015-03-27 17:06:38",
   "version": "v1.0"},
   "requestBizData": "{\"productIdList\":[2945],\"provinceId\":1}"
}
 

输入参数说明

系统参数 参数说明
timestamp 当前请求时间,格式YYYY-MM-DD HH24:MI:SS,服务端使用该参数校验请求是否过期,请将您的服务器时间进行ntp同步
appKey 调用方应用编码,由1号店分配,请注意保密
sessionKey 调用方应用密钥,由1号店分配,请注意保密
bizSource 调用方身份ID,由1号店分配
sign 请求签名,服务器使用该参数校验请求数据被篡改,签名计算方式见下文描述
version 协议版本号,当前为v1.0
requestBizData 具体接口业务数据,字符串类型,字符串格式为json
 

接口输出参数组成说明如下:

{
"returnCode": "00000000" ,
"returnName": "SUCCESS",
"returnMsg": "成功",
"errDesc": "",
"errItemList": "[{"错误1":"错误1描述"}]",
"trackId": "7b82ac22-814d-45a9-9fac-f1853772f6b6",
"responseBizData": {具体业务输出数据,json数据格式,详细见各接口说明}
}

接口输出参数说明

系统参数 参数说明
returnCode 返回编码,00000000代表接口调用成功,其他返回码代表失败
returnName 返回编码名称
returnMsg 返回结果描述
errDesc 异常描述 (有异常返回,无异常时不返回)
errItemList 异常信息列表 (有异常返回,无异常时不返回)
trackId 跟踪id,代表本次请求唯一标识。
requestBizData 具体接口业务输出数据,,json数据格式

 

提示

关闭