物流开放平台和第三方电子商务公司技术文档.doc

《物流开放平台和第三方电子商务公司技术文档.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、华强宝之[K递宝]快递接口技术文档华强宝之[K递宝]快递接口技术文档日期版本说明作者19/19华强宝之[K递宝]快递接口技术文档目录1.交互设计原则22.交互技术方案22.1交互技术说明22.2接入步骤22.3安全控制43.交互流程43.1系统交互处理流程44.提交订单接口54.1接口说明54.2接口定义55.撤销订单接口95.1接口说明95.2接口定义96.查询订单或运单物流轨迹106.1接口说明106.2接口定义107.绑定运单接口137.1接口说明137.2接口定义138.物流公司编码139.(

2、C#)DataSign签名加密过程1310.附录1419/19华强宝之[K递宝]快递接口技术文档1.交互设计原则1)安全性对于远程交互，安全第一，需要避免数据在传输过程中被篡改，避免接口被其他方调用，保证数据的隔离性。2)稳定性接口交互需要稳定性保证，避免不稳定导致的异常流程发生，对于异常流程有些很难控制，并且很容易对客户产生影响。3)可扩展性物流业务会存在较多的变化，特别是对于增值服务、运输方式、运输范围等，对于可能的变化，接口设计的尽量兼容。4)高性能电子商务发展很快，好的产品用户使用量和使用频繁

3、度肯定直线上升，需要交互的接口性能高，并且支持批量处理。2.交互技术方案2.1交互技术说明所有用户都通过华强宝之[K递宝]接入，[K递宝]所支持的情况如下：(1)支持的传输协议http建议采用http，传输通道安全目前不要求实现（https）。交互接口测试：http://113.108.103.37:808/Ebusiness/EbusinessOrderHandle.aspx测试电商ID==1109259，AppKey==56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17生产：

4、http://port.hqepay.com/Ebusiness/EbusinessOrderHandle.aspx生产(自行注册)(2)支持的数据传输格式a)Jsonb)Xml(暂不支持这种形式)(3)编码格式：UTF-8交互协议上统一用UTF-8，避免传递中文数据出现乱码。2.2接入步骤(1)注册成为华强宝的用户(注：注册成功选择服务立即使用，无需审批)注册方式通过网络平台：http://www.hqepay.com/public/apiinntroduce.html查看再注册

5、或19/19华强宝之[K递宝]快递接口技术文档http://www.hqepay.com/public/reg.html直接注册自主选择华强宝之[K递宝]快递下单接口服务我们工作人员审批通过后将给每个接入公司颁发的一组电商ID和AppKey。电商ID调用接口服务的身份证明，不可更改；AppKey是应用访问API的签名附加密钥，必须妥善保存。两者关系类似于登录帐号和密码，两者都会在签名和业务参数中使用。(1.1)注册成功之后：三项服务随意选择——>如图：点击立即使用(1.2)服务选择成功之后：查看我的电

6、商ID和AppKey——>如图：点击查看(1)开发服务开发自身业务的服务，服务需按照后面接口的定义规则。(2)查看接口调用的DEMO华强宝之[K递宝]物流技术接口提供调用[K递宝]物流接口的DEMO(.Net版本)，包括网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。提交接入处理的相关代码如有不明白的地方可与[K递宝]物流技术接口人协作开发。19/19华强宝之[K递宝]快递接口技术文档DEMO(.Net版本)下载地址：www.hqepay.com/public/HQBApi

7、_Test_For_Asp.net.rar(如链接无法打开，请打开浏览器，在浏览器中输入)2.1安全控制华强宝之[K递宝]和第三方电子商务公司系统进行对接，需要一定的安全控制。我们对安全控制要求不高，有如下方案：(1)防数据被篡改在POST请求中会传递5个参数4个必须参数：RequestType=请求指令类型EBusinessID==电商IDRequestData==数据内容(URL编码:UTF-8)DataSign==签名摘要(URL编码:UTF-8(base64(MD5(数据内容+AppKey))

8、))1个可选参数：DataType==返回数据类型(1-xml,2-json；默认为2格式)注：DataSign生成后，对方接收到数据后，以同样的算法进行签名，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改，对接过程中如有不明白之处可双方技术协作进行(2)调用接口的身份认证注册成为华强宝用户后，会生成对应的电商ID和AppKey，电商ID相当于用户名，AppKey相当于密码。注：请勿遗漏或传递可能递增大华强宝之[K递宝]接口调用维