常用快递接口,顺丰快递接口api对接调用
顺丰快递是常用快递,电商、ERP等企业都需要对接其快递接口api。对接有两种方式,第一和顺丰快递直接对接,第二,和快递鸟对接,和快递鸟对接可以一次性接入其他常用快递的接口。快递100有顺丰接口,不过只能查询不能打印电子面单,而且是收费的,菜鸟有电子面单接口,但又不支持顺丰快递。
接口平台:快递鸟免费查询接口
接口地址:ap /Ebusiness/EbusinessOrd erHandle.aspx
支持格式:json
请求方式:HTTP POST
请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
顺丰快递接口api申请JSON请求/返回示例:
1.请求
{
"OrderCode": "",
"ShipperCode": "SF",
"LogisticCode": "118650888018"
}
2.返回
没有物流轨迹的
{
"EBusinessID": "1109259",
"Traces": [],
"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": "正在派件..(派件人:邓裕富,电话:187****6310)[深圳市]",
"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",
"AcceptStation": "快件在深圳,准备送往下一站深圳集散中心[深圳市]", "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(暂不支持<content/>这种形式)。
编码格式:UTF-8
交互协议上统一用UTF-8,避免传递中文数据出现乱码。
3)、接入步骤
注册成为快递鸟用户(注:注册成功选择服务立即使用,无需审批)。注册成功后,登录就可以查看ID和key。
注册方式通过网络平台:
www.kdniao/ServiceApply.aspx(API介绍)。
按照快递鸟提示进行注册申请,注册成功并且登录,您将得到有快递鸟提供一组电商ID和AppKey。电商ID是调用接口服务的身份证明,不可更改、不可转用,AppKey是应用访问API的签名附加密钥,必须妥善保存。两者关系类似于登录帐号和密码,两者都会在签名和业务参数中使用。
url编码和utf8区别注册成功登录之后:进入我的服务查看ID和AppKey
(1)开发服务
开发自身业务的服务,服务需按照后面接口的定义规则。
(2)查看接口调用的DEMO
快递鸟物流技术接口提供调用快递鸟物流接口的DEMO(.Net版本),包括网上在线订单下单、物流轨迹查询等物流行业标准化的下单操作流程与数据查询格式。提交接入处理的相关代码如有不明白的地方可与快递鸟物流技术接口人协作开发。
DEMO下载地址:www.kdniao/ResourceDownload.aspx (如链接无法打开,请打开浏览器,在浏览器中输入)
4)、接口数据包结构
图例- 数据包结构(系统级{数据})
5)、XML范例/JSON 范例
string userID = "1109259";
string keyValue = "56da2cf8-c8a2-44b2-b6fa-476cd7d1ba17";//加密私钥,由发货通提供
string url = ":8081/Ebusiness/EbusinessOrderHandle.aspx";  //请求地址
string DataType = "1"; //1-xml;2-json
string charset="UTF-8";//字符编码采用UTF-8
string xmlStr =
"<Content><OrderCode></OrderCode><ShipperCode>SF</ShipperCode><LogisticCode>118 650888088</LogisticCode></Content>";// XML字符串
string xmlStr =
"{\"OrderCode\":\"\",\"ShipperCode\":\"SF\",\"LogisticCode\":\"118461988807\"}"; // JSON字符串
string datasign = MD5(xmlStr+keyValue, "UTF-8");//生成加密签名加密通过对参数xmlStr+ keyValue得到加密后的字符串
string PostStr = "RequestType=1002&EBusinessID= userID &RequestData=xmlStr &DataSign= datasign&DataType=DataType"; //请求报文参数
string post = this.DoPost(url, PostStr);// 通讯协议使用Http协议Post请求方式

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。