【快递单号自动识别快递公司，查询物流信息-智能单号识别API接入指南】

一.输入快递单号自动识别快递公司的方法

在快递查询的过程中,很多时候我们只有一个单号信息,并不确认是哪个快递公司运送的快递,这个时候去查询快递信息就比较麻烦.

通过快递 100 的智能单号识别 API 可以根据我们提供的快递单号，智能判断单号所归属的快递公司,结合物流查询 API 可以一键根据单号查询快递信息。

物流查询 API 介绍可以参考我之前的这篇文章（链接）。

接入快递 100 的智能单号识别接口后，对于要售后查物流的消费者来说，他们输入快递单号就能动态提示单号所属的快递公司，快速查看物流信息。

对于电商商家来说，在后台系统录入快递单号后可以自动识别所属的快递公司，如果无法识别可能是输入了错误的快递单号，来检验快递单号的正确性，减少录入失误。结合之前介绍过的物流查询 API，可以快速查询物流轨迹信息。

接下来给大家分享一下智能单号接口的接入流程，以及来实际测试下接口效果。

二.前期准备工作

在对接快递 100 智能单号识别 API 前，我们需要完成以下步骤：

1.注册

前往 快递 100API 开放平台（https://api.kuaidi100.com/home/） 注册账号。

2.获取 API Key 和 Secret

正式充值物流查询 API 的套餐后，即可开通接口，免费使用智能单号识别的服务。在快递 100 的管理后台,点击如图所示的概览,可以看到授权参数中的授权key

三.接口文档

1.接口文档地址

智能单号识别 API 文档：https://api.kuaidi100.com/document/5f1106482977d50a94e10240

2.请求地址

http://www.kuaidi100.com/autonumber/auto?num=[单号]&key=[key]

3.请求参数

请求参数（header）

请求参数（body）

4.返回结果

5.正确返回示例

[
  {
    "lengthPre": 15,
    "comCode": "yuantong",
    "name": "圆通速递"
  }
]

6.错误返回示例

{
  "returnCode": "701",
  "message": "key缺失",
  "result": false
}

7.错误返回代码含义

四.测试实战演练

1.Python 请求

Python 测试代码

import requests

# 快递单号和授权码
single_number = '906919164534'  # 请替换为您的快递单号
api_key = 'your_api_key'  # 请替换为您的授权码

# 构建请求URL
url = f'http://www.kuaidi100.com/autonumber/auto?num={single_number}&key={api_key}'

# 发送请求
response = requests.get(url)

# 检查响应状态码
if response.status_code == 200:
    # 解析响应内容
    result = response.json()

    print("返回结果：")
    print(result)
else:
    print(f"请求失败，状态码：{response.status_code}")

2.Java 请求

Java 测试代码

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class ExpressQuery {

    public static void main(String[] args) {
        // 快递单号和授权码
        String singleNumber = "906919164534"; // 请替换为您的快递单号
        String apiKey = "your_api_key"; // 请替换为您的授权码

        try {
            // 构建请求URL
            String urlString = String.format("http://www.kuaidi100.com/autonumber/auto?num=%s&key=%s", singleNumber, apiKey);
            URL url = new URL(urlString);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");
            conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

            // 检查响应状态码
            int responseCode = conn.getResponseCode();
            if (responseCode == HttpURLConnection.HTTP_OK) {
                // 读取响应内容
                BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                String inputLine;
                StringBuilder response = new StringBuilder();

                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
                in.close();

                // 打印返回结果
                System.out.println("返回结果：");
                System.out.println(response.toString());
            } else {
                System.out.println("请求失败，状态码：" + responseCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

3.api_key 获取方式

登录快递 100 的管理后台,点击如图所示的概览,可以看到授权参数中的授权key,替换上述代码中的 api_key 即可进行调用

4.返回结果

测试结果,通过调用快递智能识别单号接口,可以看到返回的结果是对应的优速快递

[
    {
        "lengthPre": 12,
        "comCode": "youshuwuliu",
        "name": "优速"
    }
]

接口返回了单号对应的快递公司编码，可以直接用于快递 100 的物流查询接口的请求参数中，这样就实现了只有快递单号，能自动识别快递公司，快速查询出物流轨迹信息。

物流查询接口的介绍可以参考我之前这篇文章（链接）

5.使用总结

通过使用快递 100 的快递智能识别单号接口,使用过程中发现对接很方便,10 分钟即可对接完成,并且查询出的结果符合我的预期,达到了我的需求目的。欢迎大家体验快递 100 的快递智能识别单号。

智能单号识别 API 文档：https://api.kuaidi100.com/document/5f1106482977d50a94e10240