快遞查詢接口調用與解析

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條那個位置。