接口地址:阿里雲全球物流快遞查詢(單號識別)
登錄阿里雲進行購買,有免費試用次數,可以免費查詢100次。
購買成功之後去阿里雲 控制檯→雲市場→已購買服務 就能看自己的接口所需要的key。
然後java調用代碼:
public static void main(String[] args) {
String host = "https://goexpress.market.alicloudapi.com";
String path = "/goexpress";
String method = "GET";
String appcode = "你自己的AppCode";
Map<String, String> headers = new HashMap<String, String>();
//最後在header中的格式(中間是英文空格)爲Authorization:APPCODE 83359fd73fe94948385f570e3c139105
headers.put("Authorization", "APPCODE " + appcode);
Map<String, String> querys = new HashMap<String, String>();
querys.put("no", "780098068058");
querys.put("type", "zto");
//JDK 1.8示例代碼請在這裏下載: http://code.fegine.com/Tools.zip
try {
/**
* 重要提示如下:
* HttpUtils請從
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
* 或者直接下載:
* http://code.fegine.com/HttpUtils.zip
* 下載
*
* 相應的依賴請參照
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
* 相關jar包(非pom)直接下載:
* http://code.fegine.com/aliyun-jar.zip
*/
HttpResponse response = HttpUtils.doGet(host, path, method, headers, querys);
//System.out.println(response.toString());如不輸出json, 請打開這行代碼,打印調試頭部狀態碼。
//狀態碼: 200 正常;400 URL無效;401 appCode錯誤; 403 次數用完; 500 API網管錯誤
//獲取response的body
System.out.println(EntityUtils.toString(response.getEntity()));
} catch (Exception e) {
e.printStackTrace();
}
}
注意看重要提示,要先寫一個HttpUtils類,然後引入jar包或者pom依賴。
正常返回示例:
{
"code": "OK",
"no": "780098068058",
"type": "ZTO",
"list": [{
"content": "【石家莊市】 快件已在 【長安三部】 簽收,簽收人: 本人, 感謝使用中通快遞,期待再次爲您服務!",
"time": "2018-03-09 11:59:26"
}, {
"content": "【石家莊市】 快件已到達 【長安三部】(0311-85344265),業務員 容曉光(13081105270) 正在第1次派件, 請保持電話暢通,並耐心等待",
"time": "2018-03-09 09:03:10"
}, {
"content": "【石家莊市】 快件離開 【石家莊】 發往 【長安三部】",
"time": "2018-03-08 23:43:44"
}, {
"content": "【石家莊市】 快件到達 【石家莊】",
"time": "2018-03-08 21:00:44"
}, {
"content": "【廣州市】 快件離開 【廣州中心】 發往 【石家莊】",
"time": "2018-03-07 01:38:45"
}, {
"content": "【廣州市】 快件到達 【廣州中心】",
"time": "2018-03-07 01:36:53"
}, {
"content": "【廣州市】 快件離開 【廣州花都】 發往 【石家莊中轉】",
"time": "2018-03-07 00:40:57"
}, {
"content": "【廣州市】 【廣州花都】(020-37738523) 的 馬溪 (18998345739) 已攬收",
"time": "2018-03-07 00:01:55"
}],
"state": "3", /* -1:單號或代碼錯誤;0:暫無軌跡;1:快遞收件;2:在途中;3:簽收;4:問題件 5.疑難件 6.退件簽收 */
"msg": "查詢成功",
"name": "中通快遞", /* 快遞公司名稱 */
"site": "www.zto.com", /* 快遞公司官網 */
"phone": "95311", /* 快遞公司電話 */
"courier": "容曉光", /* 快遞員 或 快遞站(沒有則爲空)*/
"courierPhone":"13081105270", /* 快遞員電話 (沒有則爲空) */
"updateTime":"2019-08-27 13:56:19", /* 快遞軌跡信息最新時間 */
"takeTime":"2天20小時14分", /* 發貨到收貨消耗時長 (截止最新軌跡) */
"logo": "http://img3.fegine.com/express/zto.jpg" /* 快遞Logo */
}
錯誤返回示例:
{"code":"205","no":"7800980680581","type":"ZTO","list":[],"state":"0","msg":"暫無軌跡信息"}
錯誤碼定義:
錯誤碼 | 錯誤信息 | 描述 |
---|---|---|
201 | 快遞單號錯誤 | 快遞單號錯誤 |
203 | 快遞公司不存在 | 快遞公司不存在 |
204 | 快遞公司識別失敗 | 快遞公司識別失敗 |
205 | 沒有信息 | 沒有信息 |
207 | 該單號被限制,錯誤單號 | 該單號被限制,錯誤單號 |
-1 | 單號或快遞公司錯誤 | 單號或快遞公司錯誤 |
OK | 查詢成功 | 查詢成功 |