《顺丰快递接口api对接调用demo资料》由会员分享,可在线阅读,更多相关《顺丰快递接口api对接调用demo资料(14页珍藏版)》请在金锄头文库上搜索。
1、免费顺丰快递接口api对接调用demo接口地址:http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx支持格式:json 请求方式:HTTP POST接口平台:快递鸟免费查询接口 请求方法的编码格式(utf-8):application/x-www-form-urlencoded;charset=utf-8。顺丰快递接口api申请JSON请求/返回示例:1.请求OrderCode:,ShipperCode:SF,LogisticCode:1186508880182.返回没有物流轨迹的 EBusinessID: 1109259, Trace
2、s: , OrderCode: , ShipperCode: SF, LogisticCode: 118461988807, Success: false, Reason: null有物流轨迹的 EBusinessID: 1109259, OrderCode: , ShipperCode: SF, LogisticCode: 118461988807, Success: true, State: 3, Reason: null, Traces: AcceptTime: 2014/06/25 08:05:37, AcceptStation: 正在派件.(派件人:邓裕富,电话:1871886631
3、0)深圳 市, Remark: null , AcceptTime: 2014/06/25 04:01:28, AcceptStation: 快件在 深圳集散中心 ,准备送往下一站 深圳 深圳市, Remark: null , AcceptTime: 2014/06/25 01:41:06, AcceptStation: 快件在 深圳集散中心 深圳市, Remark: null , AcceptTime: 2014/06/24 20:18:58, AcceptStation: 已收件深圳市, Remark: null , AcceptTime: 2014/06/24 20:55:28, Acc
4、eptStation: 快件在 深圳 ,准备送往下一站 深圳集散中心 深圳市, Remark: null , AcceptTime: 2014/06/25 10:23:03, AcceptStation: 派件已签收深圳市, Remark: null , AcceptTime: 2014/06/25 10:23:03, AcceptStation: 签收人是:已签收深圳市, Remark: null 注:接口及签名说明1)、支持http传输协议2)、支持的数据传输格式 Json/Xml(暂不支持这种形式)。 编码格式:UTF-8 交互协议上统一用UTF-8,避免传递中文数据出现乱码。3)、接入
5、步骤 注册成为用户(注:注册成功选择服务立即使用,无需审批)。注册成功后,登录就可以查看ID和key。 注册方式通过网络平台:按照接口官网提示进行注册申请,注册成功并且登录,将得到一组电商ID和AppKey。电商ID是调用接口服务的身份证明,不可更改、不可转用,AppKey是应用访问API的签名附加密钥,必须妥善保存。两者关系类似于登录帐号和密码,两者都会在签名和业务参数中使用。注册成功登录之后认证:即可申请接口 申请后ID和KEY自动激活(1) 开发服务开发自身业务的服务,服务需按照后面接口的定义规则。(2) 查看接口调用的DEMO物流技术接口提供调用物流接口的DEMO(.Net版本),包括
6、网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。提交接入处理的相关代码如有不明白的地方可与物流技术接口人协作开发。DEMO下载地址:http:/ 4)、接口数据包结构图例 - 数据包结构 (系统级数据)5)、XML范例/JSON 范例 string userID = 1109259; string keyValue = 56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17;/加密私钥,由发货通提供 string url = http:/api.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx;
7、/请求地址 string DataType = 1; /1-xml;2-json string charset=UTF-8;/字符编码采用UTF-8 string xmlStr = SF118650888088;/ XML字符串 string xmlStr = OrderCode:,ShipperCode:SF,LogisticCode:118461988807; / JSON字符串string datasign = MD5(xmlStr+keyValue, UTF-8);/生成加密签名加密通过对参数xmlStr+ keyValue得到加密后的字符串string PostStr = Reque
8、stType=1002&EBusinessID= userID &RequestData=xmlStr &DataSign= datasign&DataType=DataType; /请求报文参数string post = this.DoPost(url, PostStr);/ 通讯协议使用Http协议Post请求方式6)、流程示意图7)、网关地址测试接口:http:/api.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx测试电商ID=1237100,AppKey=518a73d8-1f7f-441a-b644-33e77b49d846正式
9、接口:http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx注意:正式(自行注册)环境下使用时,需提供请求的IP给接口登记8)、关于签名接口和第三方电子商务公司系统进行对接,有一定的安全机制。采用IP认证加签名的方式对接,具体方案如下:(1) 防止数据被篡改在POST请求中会传递5个参数4个必须参数:RequestType=请求指令类型EBusinessID=电商IDRequestData=数据内容(URL编码:UTF-8)DataSign= 签名摘要(URL编码:UTF-8(base64(MD5(数据内容 +AppKey)1个可选参数:
10、DataType=返回数据类型(1-xml,2-json;默认为2格式)注:DataSign生成后,对方接收到数据后,以同样的算法进行签名,生成摘要,对比两者的摘要是否相同,如果不同,说明传递过程中发生数据篡改,对接过程中如有不明白之处可双方技术协作进行(2) 调用接口的身份认证注册成为接口用户后,会生成对应的电商ID和AppKey,电商ID相当于用户名,AppKey相当于密码。注:请勿遗漏或传递可能递增大接口调用维护举例说明:(a) 假设RequestData (XML)内容为: SF118954907573,经过URL(UTF-8)编码的内容为%3cContent%3e%3cShipper
11、Code%3eSF%3c%2fShipperCode%3e%3cLogisticCode%3e118954907573%3c%2fLogisticCode%3e%3c%2fContent%3e, EBusinessID为1109259,AppKey为56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17(b) 那么DataSign签名的内容为SF11895490757356da2cf8-c8a2-44b2-b6fa-476cd7d1ba17,经过md5和base64后的内容就为YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE=,在经过UR
12、L(UTF-8)编码的内容为YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE%3d(c) 最终要发送的数据为RequestType=1002&EBusinessID=1109259&RequestData =%3cContent%3e%3cShipperCode%3eSF%3c%2fShipperCode%3e%3cLogisticCode%3e118954907573%3c%2fLogisticCode%3e%3c%2fContent%3e &DataSign = YzBjODA3MjA2NmViM2ZlZGMyNWNjMDA0NDRiMDdmOTE%3d& DataType=2(d) 接收方收到数据后,获得EBusinessID 和RequestData和DataSign等这几个数据