- 1、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。。
- 2、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
漫游超人合作伙伴对接 API文档1.0
前言A概述
本文档详细介绍了漫游超人和合作商(代理商)对接所需接口及其规范 ,用于指导合作商与
漫游超人订单系统(以下简称 OMS )进行对接。
前言B修订记录
日期
版本
描述
作者
2017-08-25
V1.1
张咪
前言C数据交互与安全
C1传输协议
采用 HTTP 协议POST请求
C2数据格式
请求和响应均采用 json格式, 编码格式统一为 utf-8, Base64后传输
C3签名算法
交互的信息做到加密、防篡改」
1.将消息体用json格式,编码格式统一为 utf-8,
Base64后传输
2.冋时将账号、请求时间、 Base64编码后的请求
body和秘钥MD5后生成签名:
sig n=toUpperCase(MD5(acco un tId + requestTime + Base64(js on( data)) + secretkey))
3.最后,将完整消息体进行 Base64编码发送
示例: 原始data消息体:
{
partnerOrderId: 2017040260001
}
将dataBase64后,加上生成的签名 sigin(签名生成前面已阐述)、账号、请求时间,组装成
如下格式的json :
accountld: JKISSKOIKSKSKKS,
requestTime: 2017-04-26 06:06:00,
sign: 37C0174058090DE97062755861E565C2,
data: ewoglCJ0dW5pdU9yZEIkljogMjU1NjAxCn0=
最终将上述格式的json数据整体Base64编码:
ewoglCJhY2NvdW50SWQQAidG4tMzlzliwKICAicmVxdWVzdFRpbWUiOiAiMjAxNi0wNi0wMyAwNjowNjo wMCIsCiAglnNpZ24iOiAiMzdDMDE3NDA1ODA5MERFOTcwNjl3NTU4NjFFNTY1QzliLAoglCJkYXRhljoglm V3b2dJQ0owZFc1cGRV0XlaRWxrSWpvZ01qVTF0akF4Q24wPSIKfQ==
注:1?合作商调用OMS提供的接口,
OMS提供给供应商账号和密钥进行验证
2. OMS
调用合作商提供的通知接口,合作商提供给
OMS账号和密钥3. OMS调用内部转换接口,
内部提供机构代码和秘钥
1下单接口
1.1应用场景
合作商调用该接口下单请求, OMS会判断合作商订单号在是否存在,若存在直接返回下单
成功结果;若不存在,创建订单,返回下单结果。
1.2接口说明
提供者
接口地址
出入参格式
OMS测试)
/oms/thirdPart/createOrder
Base64(jso n)
OMS生产环境)
/oms-ota-web/api/create
Base64(jso n)
1.3报文格式
1.3.1入参样例:
原始data消息体:
{
address: 详细地址,
city: 郑州市,
contactMobile
contactName: 张咪,
deliverPointld:CN00031,
deliverPointName: 广州白云机场网点,
depositAmount:500,
depositMode:1,
district: 市辖区,
endTime:2017-08-21,
isSendSms:1,
note:amyzhang 测试,
partnerOrderld:201721195,
productld:PKG00211,
province: 河南省,
quantity:3,
returnPointld:CN00031,
returnPointName: 广州白云机场网点 11,
shipWay:2,
startTime:2017-08-11
}
原始data消息体加密,加上账号、签名、请求时间后:
{accountld:JS0S0SJIW0D8830SD0KSKS,
data:eyJhZGRyZXNzljoi6K+m57uG5Zyw5Z2AliwiY2IOeSI6lumDkeW3nuW4gilslmNvbnRhY3RNb2J pbGUiOilxMzM2MDUxMDcyMCIslmNvbnRhY3ROYW1lljoi5byg5ZKqliwiZGVsaXZIclBvaW50SWQQJDTj AwMDMxliwiZGVsaXZIclBvaW50TmFtZSI6luW5v+W3nueZveS6keacuuWcuue9keeCuSlslmRlcG9zaXRBb
W91bnQiOjUwMCwiZGVwb3NpdE1vZGUiOjEslmRpc3Rya
文档评论(0)