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 查询成功 查询成功
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章