对接说明

开发信息#

接口地址#

提示

https协议 + 域名 + 固定请求路径 + 方法名

测试环境接口地址(暂无)：https://域名/api/customer/operation/{方法名}

正式环境接口地址（也可用于对接测试）：https://wmsapi.epsglobe.net/api/customer/operation/{方法名}

密钥获取#

💡

正式环境-测试密钥（对接测试专用）
appKey: a5ca990e06c16e5eb0846f934bf1fb36
appSecret: Q0M0QURFMzE1RUVCMDg5QjE3QUI5MzFEQzNDNzcwOUYpKComXiZeNWVwcw

📌

正式环境-正式密钥（对接上线专用）
appKey|appSecret
请到OMS客户端：头像->个人中心->API KEY栏目 获取，见下图。

签名算法#

📌

通过以下4个字段构造签名：
appKey|appSecret|timestamp|requestBody

1.

timestamp：10位时间戳

2.

requestBody：根据请求接口而定，如果没有则为空字符串

字段需按上述顺序进行拼接，字段中间无任何符号！！！

请求说明#

📌

每个接口方法都需传 RequestHeader 参数，请求头说明，如下表：

属性	类型	描述	必填
apikey	String	API 授权码	Y
signature	String	签名，根据签名算法生成	Y
timestamp	String	请求时间戳，精确到秒（10 位数字）。	Y
sourceFrom	String	平台标识，传拼音。（例如：领星：lingxing、易仓：yicang、店小秘：dianxiaomi、旺店通：wangdiantong、积加：jijia、千易：qianyi、赛狐：saihu、自研ERP：ziyan 等等...）	Y
Content-Type	String	固定为: application/json;charset=UTF-8	Y

接口返回结构#

💡

result中存在一个data属性(固定)，其值根据所对应的接口而定，或为数组，或为集合。

{
	"code": 0,     // 返回代码
	"message": "", // 返回处理消息
	"result": {},  // 返回数据对象
	"success": true, // 成功标志
	"timestamp": 0  // 时间戳
}

状态码#

📌

详细信息以状态码所对应的message为准。

状态码	描述
200	成功
400	请求失败，详细见描述（message）
401	鉴权失败
403	无权限访问
405	请求方法不允许
422	请求数据异常
429	请求太频繁
10xxx	订单相关
11xxx	库存相关
12xxx	入库相关
13xxx	商品相关
14xxx	换单相关
15xxx	退货相关