接口名称:快递物流信息查询
接口用途:输入快递单号和快递代号查询实时物流信息,支持国内外1500+物流快递公司的物流跟踪服务,包括顺丰、圆通、申通、中通、韵达等主流快递公司。同时,支持单号识别快递物流公司,返回快递运送轨迹及状态等信息。
以下为具体的Java实现代码过程:
public static void main(String[] args) {
String host = "https://kzexpress.market.alicloudapi.com";
String path = "/api-mall/api/express/query";
String method = "POST";
String appcode = "你自己的AppCode";
Map<String, String> headers = new HashMap<String, String>();
//最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105
headers.put("Authorization", "APPCODE " + appcode);
//根据API的要求,定义相对应的Content-Type
headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>();
bodys.put("expressNo", "expressNo");
bodys.put("mobile", "mobile");
try {
/**
* 重要提示如下:
* HttpUtils请从
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
* 下载
*
* 相应的依赖请参照
* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
*/
HttpResponse response = HttpUtils.doPost(host, path, method, headers, querys, bodys);
System.out.println(response.toString());
//获取response的body
//System.out.println(EntityUtils.toString(response.getEntity()));
} catch (Exception e) {
e.printStackTrace();
}
}
返回的数据结构如下:
"msg": "成功",
"success": true,
"code": 200,
"data": {
"cpCode": "SF",// 快递公司编码
"mailNo": "SF13xxx",//快递编号
"theLastTime": "2023-04-21 19:06:47",//运单号物流流转当前最新变更时间
"cpMobile": "95338",//快递公司电话
"theLastMessage": "快件到达 【贵阳双龙中转场】",//运单号物流流转当前最新描述
"logisticsCompanyName": "顺丰快递",//快递公司名称
"cpUrl": "http://www.sf-express.com",//快递公司官网
"logisticsStatusDesc": "运输中",//运单号当前物流状态文字描,
"logisticsTraceDetailList": [
{
"areaCode": "",//非必须,当前节点所在地址行政编码
"areaName": "温州市",//非必须,当前节点所在地区,省,市,区或省,市
"subLogisticsStatus": "ACCEPT",//物流流转子状态
"time": 1718767062000,//时间,单位毫秒
"logisticsStatus": "ACCEPT",//物流流转状态
"desc": "顺丰速运 已收取快件"//物流流转描述
},
{
"areaCode": "",
"areaName": "宁波市",
"subLogisticsStatus": "AGENT_SIGN",
"time": 1718849806000,
"logisticsStatus": "SIGN",
"desc": "您的快件代签收(家门口),如有疑问请电联快递员【杨***,电话:19****237】,感谢您使用顺丰,期待再次为您服务。(主单总件数:1件)"
}
],
"logisticsStatus": "SIGN"