快递查询接口调用与解析

刚开发完一个网站的快递查询接口,觉得非常好,调用简单,返回结果简单xml与json格式的都支持,在这里记录一下,顺便也与大家分享一下,做外贸的可以作为参考

gotrace 快递查询接口介绍

下面分别介绍提供的两种请求方式:

第一种:请求返回XML格式的结果数据

请求地址方法名为:http://www.gotrace.cn/gotrace/delivery/search.xml

请求只接受post方式提交数据请求

请求参数:

key:授权key,可以联系gotrace的技术人员,直接在http://www.gotrace.cn的联系我们中可以联系上

company:快递公司代码,可以在gotrace的官网上查询到,地址:http://www.gotrace.cn/gotrace/help

no:快递单号,这个是你自己的快递单号

数据以post方式提交到gotrace,可以直接写一个最简单的html来测试的。可以向他们所要测试账号进行,这里就不提供了。

返回XML结果案例:

<result>
  <company>ems</company>
<deliveredDate/>
<fromAddress/>
<fromCountry>中国</fromCountry>
<fromDetail>
2013-09-01 19:52:00 上海邮政速递物流大宗邮件收寄处 收寄<br/>2013-09-01 20:04:00 上海邮政速递物流大宗邮件收寄处 离开处理中心,发往上海市邮政公司邮政速递局<br/>2013-09-01 20:17:11 上海市 到达处理中心,来自上海邮政速递物流大宗邮件收寄处<br/>2013-09-01 20:22:41 上海市 离开处理中心,发往纽约(肯尼迪)<br/>
</fromDetail>
<message>search ok.</message>
<no>EE971646741CN</no>
<signature/>
<status>3</status>
<statusDesc>Delivered</statusDesc>
<toAddress/>
<toCountry>美国</toCountry>
<toDetail>
September 4, 2013 , 10:26 am Delivered ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 8:19 am Out for Delivery ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 8:09 am Sorting Complete ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 5:03 am Arrival at Post Office ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 Depart USPS Sort Facility BELLMAWR, NJ 08099 <br/>September 4, 2013 , 12:56 am Processed through USPS Sort Facility BELLMAWR, NJ 08099 <br/>September 3, 2013 , 12:42 pm Processed Through Sort Facility ISC NEW YORK NY(USPS) <br/>September 1, 2013 , 8:22 pm Processed Through Sort Facility SHANGHAI EMS, CHINA<br/>September 1, 2013 , 7:52 pm Acceptance CHINA<br/>
</toDetail>
</result>
其中的结果属性说明:
company:就是你查询的是哪家快递公司的快递
deliveredDate:签收日期,这个有的快递公司没有提供结果,根据实际快递公司的官网而定
fromAddress:发货地址
fromCountry:发件国家
fromDetail:发件国家的快递投递历史记录
message:本次查询的结果描述
no:快递单号
signature:签收人,在部分快递公司中查询返回,根据实际快递公司的官网而定
status:快递状态(0:在途中,1:没有查询到快递信息,2:疑难件,3:已签收,4:已退件)
statusDesc:快递状态的描述,这个快递实际在官网上的描述是什么样子的,原文返回。
toAddress:收件地址,部分快递公司能够查询到
toCountry:收件国家
toDetail:收件国家的投递历史记录

第二种:请求返回JSON格式的结果数据

请求地址方法名为:http://www.gotrace.cn/gotrace/delivery/search.json

请求只接受post方式提交数据请求

请求参数:

key:授权key,可以联系gotrace的技术人员,直接在http://www.gotrace.cn的联系我们中可以联系上

company:快递公司代码,可以在gotrace的官网上查询到,地址:http://www.gotrace.cn/gotrace/help

no:快递单号,这个是你自己的快递单号

数据以post方式提交到gotrace,可以直接写一个最简单的html来测试的。可以向他们所要测试账号进行,这里就不提供了。

返回JSON结果案例:

{"message":"search ok.","no":"EE971646741CN","company":"ems","toAddress":"","toCountry":"美国","fromAddress":"","fromCountry":"中国","status":"3","statusDesc":"Delivered","fromDetail":"2013-09-01   19:52:00 上海邮政速递物流大宗邮件收寄处 收寄<br/>2013-09-01   20:04:00 上海邮政速递物流大宗邮件收寄处 离开处理中心,发往上海市邮政公司邮政速递局<br/>2013-09-01   20:17:11 上海市 到达处理中心,来自上海邮政速递物流大宗邮件收寄处<br/>2013-09-01   20:22:41 上海市 离开处理中心,发往纽约(肯尼迪)<br/>","toDetail":"September 4, 2013 , 10:26 am Delivered ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 8:19 am Out for Delivery ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 8:09 am Sorting Complete ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 , 5:03 am Arrival at Post Office ATLANTIC CITY, NJ 08401 <br/>September 4, 2013 Depart USPS Sort Facility BELLMAWR, NJ 08099 <br/>September 4, 2013 , 12:56 am Processed through USPS Sort Facility BELLMAWR, NJ 08099 <br/>September 3, 2013 , 12:42 pm Processed Through Sort Facility ISC NEW YORK NY(USPS) <br/>September 1, 2013 , 8:22 pm Processed Through Sort Facility SHANGHAI EMS, CHINA<br/>September 1, 2013 , 7:52 pm Acceptance CHINA<br/>","deliveredDate":"September 4, 2013 , 10:26 am","signature":""}

返回结果中的属性与XML返回结果中的属性是一样的

Gotrace快递查询公司代码对照表【请参考官网:http://www.gotrace.cn/gotrace/help】,代码表在页面当中的第4条那个位置。

快递查询接口调用与解析

上一篇:Cordic算法


下一篇:sizeof,一个其貌不扬的家伙(转)