一、背景：电商时代下的物流信息整合需求

在电商系统中，用户对订单状态的实时感知已成为基本体验。然而，国内主流快递公司超过百家，每家使用独立的查询接口和数据格式，若由前端逐一调用，开发成本高且维护困难。

为此，统一的物流查询接口成为系统集成的关键环节。通过封装多快递平台协议，开发者可实现“一次接入，多平台查询”，提升系统效率与用户体验。

二、技术实现路径

1. 多快递公司数据对接架构

支持国内外2000多家快递公司跟踪服务

三、开发调试流程

1. 获取快递公司编码
   调用“快递公司查询”接口，获取各快递公司的标准编码（如 yunda、shentong）

2. 发起物流查询
   使用编码 + 单号调用查询接口，获取轨迹数据。

三、Python 调用示例

import requests

def query_express(company_code, tracking_number, api_key):
    url = "https://www.tanshuapi.com/market/detail-68"  # 实际接口地址
    payload = {
        "company": company_code,
        "number": tracking_number,
        "key": api_key
    }
    try:
        response = requests.post(url, json=payload, timeout=10)
        return response.json()
    except Exception as e:
        return {"error": str(e)}

# 使用示例
result = query_express("yunda", "1234567890", "your_api_key")
if result.get("code") == 1:
    for item in result["data"]["list"]:
        print(f"{item['time']}: {item['status']}")