通信协议

协议描述

接口遵循REST规范,使用HTTP POST方式进行通讯。

标准协议的HTTP入口地址为:

商家推送发给九曳:

http://[erp_url]?method=[wms_API]&timestamp=[2015-02-01 00:00:00]&format=xml&app_key=[wms_appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[USR1]

九曳回传给商家:

http://[erp_url]?method=[erp_API]&timestamp=[2015-02-01 00:00:00]&format=xml&app_key=[wms_appkey]&v=1.0&sign=[xxxxxxxxxxxxxxxxxxxxxx]&sign_method=md5&customerId=[USR1]

注:

1.[ ] 需要根据具体业务进行填写。erp_API,wms_API具体见下方的API名称。

2.URL需要做URL Encoding处理。

3.请求和响应的消息主体使用XML格式。

请求参数

请求参数包含URL中带的系统参数和BODY中带的相关业务参数,以下是系统参数:

参数 参数说明 类型 约束
method 九曳相关的业务接口名称,如商品信息同步的请求,method= item.synchronize string 必须
timestamp 时间戳,格式为yyyy-mm-dd HH:mm:ss string 必须
format content格式 string XML
app_key 应用接入时WMS提供的appkey string 必须
v 协议版本号,1.0或者2.0 string 必须
sign 根据url和密钥计算的结果。具体算法参看附录 string 必须
sign_method 参数加密方法,md5(32位) - -
customerid WMS颁发给用户的ID string 必须

响应参数

响应参数包含系统参数和业务参数。以下是系统参数:

参数 参数说明 类型 约束
flag success/failure string(50) 必须
code 返回状态码 string(50) 必须
message 返回状态描述 string(200) 必须