接口地址:阿里云全球物流快递查询(单号识别)
登录阿里云进行购买,有免费试用次数,可以免费查询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 | 查询成功 | 查询成功 |