快递物流查询-快递查询-快递单号查询-快递物流单号查询-快递物流轨迹查询-快递物流查询接口

news2024/12/27 13:36:55

快递物流查询接口（API）是一种允许开发者通过编程方式实时查询快递物流信息的服务。这些接口通常集成了多家快递公司的物流数据，为电商平台、物流管理系统、个人用户等提供便捷的物流查询服务。以下是关于快递物流查询接口的一些详细介绍：

一、功能特点

多快递公司支持：快递物流查询接口通常支持国内外多家主流快递公司，如顺丰、中通、圆通、申通、韵达、EMS、DHL、UPS等，确保用户能够查询到广泛的物流信息。
实时更新：接口能够实时从快递公司系统中获取最新的物流信息，包括包裹的当前位置、运输状态、预计送达时间等，帮助用户随时掌握包裹动态。
批量查询：支持批量导入快递单号进行查询，提高查询效率，特别适合电商平台、物流公司等需要处理大量快递单号的企业用户。
自动推送：部分接口提供自动推送服务，当包裹状态发生变化时，会自动将最新的物流信息推送给用户，无需用户手动查询。
数据分析：部分高级接口还提供数据分析功能，如统计运输时效、分析物流渠道表现等，帮助用户优化物流管理和决策。

二、使用场景

电商平台：电商平台可以集成快递物流查询接口，为用户提供便捷的物流查询服务，提升用户体验。
物流公司：物流公司可以使用这些接口来优化自己的物流管理系统，提高运营效率。
个人用户：个人用户也可以通过第三方应用或网站使用这些接口来查询自己的快递物流信息。

三、接入方式

注册与认证：通常需要先在接口提供商的网站上注册账号，并进行身份认证。
获取API密钥：注册成功后，会获得一个API密钥（或称为Access Token），用于后续请求的身份验证。
发送请求：根据接口提供商提供的文档，构造HTTP请求，将需要查询的快递单号和其他参数发送到指定的URL地址。
接收响应：接口提供商会返回包含物流信息的JSON或XML格式的数据，开发者需要解析这些数据并展示给用户。

四、注意事项

数据安全：在使用接口时，需要确保传输的数据安全，避免泄露用户隐私。
请求频率限制：部分接口提供商会对请求频率进行限制，以避免服务器过载。因此，在使用时需要注意控制请求频率。
费用问题：部分接口提供商会收取一定的费用，特别是在处理大量数据时。因此，在选择接口时需要考虑成本问题。

综上所述，快递物流查询接口为用户提供了便捷、实时的物流查询服务，在电商、物流等多个领域都有广泛的应用。在选择接口时，需要根据自己的需求和预算进行综合考虑。

Java代码开发

//https://market.aliyun.com/apimarket/detail/cmapi00066593?spm=5176.730005.result.50.6281414ahmda6V#sku=yuncode6059300002
	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"
    }
}

物流状态

序号	物流主状态	状态描述	物流子状态	子状态描述
1	WAIT_ACCEPT	待揽收	RECEIVE	接单中
1	WAIT_ACCEPT	待揽收	WAIT_ACCEPT	待揽收
2	ACCEPT	已揽收	ACCEPT	已揽收
3	TRANSPORT	运输中	TRANSPORT	运输中
			SEND_ON	转单或修改地址转寄
			ARRIVE_CITY	到达目的城市
4	DELIVERING	派件中	DELIVERING	派件中
4	DELIVERING	派件中	STA_INBOUND	已放入快递柜或驿站
5	AGENT_SIGN	已代签收	AGENT_SIGN	已代签收
6	SIGN	已签收	SIGN	已签收
			STA_SIGN	从快递柜或者驿站取出
			RETURN_SIGN	退回签收
7	FAILED	包裹异常	FAILED	包裹异常
			REFUSE_SIGN	拒收
			DELIVER_ABNORMAL	派件异常
			RETENTION	滞留件
			ISSUE	问题件
			RETURN	退回件
			DAMAGE	破损
			CANCEL_ORDER	揽件取消