java調用快遞物流接口api

接口地址:阿里雲全球物流快遞查詢(單號識別)

 登錄阿里雲進行購買,有免費試用次數,可以免費查詢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 查詢成功 查詢成功
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章