一、什么是物流快递查询接口?
快递物流接口是一种用于获取快递包裹运输状态和相关信息的技术接口。
二、它的主要作用包括哪些?
- 电商平台:为电商平台提供实时的物流跟踪信息,让消费者能够及时了解自己购买商品的运输进度,提升购物体验。例如,淘宝、京东等电商平台通过接入快递物流接口,为用户展示详细的物流轨迹。
- 物流企业:方便物流企业内部管理和优化物流流程,提高物流效率和服务质量。像顺丰、圆通等物流公司利用接口实现订单管理和运输调度的自动化。
- 第三方应用:一些专门的物流查询应用或工具,通过接入不同的快递物流接口,为用户提供一站式的物流查询服务。
三、以下是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": "顺丰速运 已收取快件"//物流流转描述
},
{