华强宝之[K宝]快递接口技术文档.docVIP

华强宝之[K递宝]快递接口技术文档 日期 版本 说明 作者 目录 1. 交互设计原则 2 2. 交互技术方案 2 2.1 交互技术说明 2 2.2 接入步骤 2 2.3 安全控制 4 3. 交互流程 4 3.1 系统交互处理流程 4 4. 提交订单接口 5 4.1 接口说明 5 4.2 接口定义 5 5. 撤销订单接口 9 5.1 接口说明 9 5.2 接口定义 9 6. 查询订单或运单物流轨迹 10 6.1 接口说明 10 6.2接口定义 10 7. 绑定运单接口 13 7.1 接口说明 13 7.2 接口定义 13 8. 物流公司编码 13 9.(C#)DataSign签名加密过程 13 10.附录 14 交互设计原则 安全性 对于远程交互，安全第一，需要避免数据在传输过程中被篡改，避免接口被其他方调用，保证数据的隔离性。 稳定性 接口交互需要稳定性保证，避免不稳定导致的异常流程发生，对于异常流程有些很难控制，并且很容易对客户产生影响。 可扩展性 物流业务会存在较多的变化，特别是对于增值服务、运输方式、运输范围等，对于可能的变化，接口设计的尽量兼容。 高性能 电子商务发展很快，好的产品用户使用量和使用频繁度肯定直线上升，需要交互的接口性能高，并且支持批量处理。 交互技术方案 交互技术说明 所有都通过接入，所支持的情况如下： 支持的传输协议 http 建议采用http，传输通道安全目前不要求实现（https）。7:808/Ebusiness/EbusinessOrderHandle.aspx 测试电商ID==1109259，56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17 生产：/Ebusiness/EbusinessOrderHandle.aspx 生产(自行注册) 支持的数据传输格式 Json Xml 编码格式：UTF-8 交互协议上统一用UTF-8，避免传递中文数据出现乱码。 接入步骤 成为/public/apiinntroduce.html查看再注册 或 /public/reg.html直接注册 自主选择华强宝之[K递宝]快递下单接口服务我们工作人员给每个颁发的一组和AppKey。服务的身份证明，不可更改；AppKey是应用访问API的签名附加密钥，必须妥善保存。两者关系类似于登录帐号和密码，两者都会在签名和业务参数中使用。 (1.2)服务选择成功之后：查看我的电商ID和AppKey——如图：点击查看 开发服务 开发自身业务的服务，服务需按照后面接口的定义规则。 查看接口调用的DEMO 技术接口调用接口的DEMO，提交接入处理的相关代码技术接口人。DEMO(.Net版本)下载地址：/public/HQBApi_Test_For_A.rar(如链接无法打开，请打开浏览器，在浏览器中输入) 安全控制 和第三方公司系统进行对接，需要一定的安全控制。我们对安全控制要求不高，有如下方案： 防数据被篡改 在POST请求中会传递RequestData==数据内容(URL编码:UTF-8) DataSign== 签名摘要(URL编码:UTF-8(base64(MD5(数据内容 +AppKey)))) 1个可选参数： DataType==返回数据类型(1-xml,2-json；默认为2格式) 注：DataSign生成，对方接收到数据后，以同样的算法进行签名，生成摘要，对比两者的摘要是否相同，如果不同，说明传递过程中发生数据篡改调用接口的身份认证 注册成为后，会生成对应的AppKey，相当于用户名，AppKey相当于密码。增大接口维护 举例说明： 假设RequestData 内容为： ContentShipperCodeSF/ShipperCodeLogisticCode118954907573/LogisticCode/Content，%3cContent%3e%3cShipperCode%3eSF%3c%2fShipperCode%3e%3cLogisticCode%3e118954907573%3c%2fLogisticCode%3e%3c%2fContent%3e， EBusinessID为1109259，AppKey为56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17 那么签名的内容为ContentShipperCodeSF/ShipperCodeLogisticCode118954907573/LogisticCode/Content56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17，经过md5和base64后的内容就为YzBjODA3MjA2NmViM2Z