ITPub博客

首页 > 应用开发 > IT综合 > 快递查询接口调用与解析

快递查询接口调用与解析

原创 IT综合 作者:gotrace 时间:2014-01-29 10:59:58 0 删除 编辑

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结果案例:

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

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

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

来自 “ ITPUB博客 ” ,链接:http://blog.itpub.net/29451685/viewspace-1076406/,如需转载,请注明出处,否则将追究法律责任。

上一篇: 没有了~
下一篇: 没有了~
请登录后发表评论 登录
全部评论

注册时间:2014-01-20

  • 博文量
    1
  • 访问量
    7011