快递查询 API 对接指南(Python示例)

本文涉及的产品
对象存储 OSS,20GB 3个月
文件存储 NAS,50GB 3个月
对象存储OSS,敏感数据保护2.0 200GB 1年
简介: 在电商与物流快速发展背景下,实时快递查询成为系统开发常见需求。本文介绍如何通过快递查询API快速集成物流信息,提升自动化水平与用户体验,并提供Python调用示例及问题解决方案。

在电商和物流行业快速发展的背景下,实时获取快递信息已成为系统开发中的常见需求。本文介绍如何通过快递查询API快速实现物流信息集成,以提升系统的自动化水平与用户体验。
一、接口概览
image.png

请求方式:GET

返回格式:JSON

响应示例:

js{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "company": "中通快递",
    "com": "zto",
    "no": "78792812069699",
    "status_desc": "已签收",
    "list": [
      {
        "datetime": "2024-05-04 15:58:17",
        "remark": "【东莞市】已签收..."
      },
      ...
    ]
  }
}

二、Python 调用示例

  1. 安装依赖
    image.png
  1. 核心调用函数
jsimport os
import sys
import requests

def query_express(com: str, no: str) -> dict:
    """
    查询快递物流信息。
    :param com: 快递公司编码,如 zto、ems
    :param no: 快递单号
    :return: JSON 响应数据
    """
    app_code = os.getenv("TANSHU_APPCODE")
    if not app_code:
        print("请设置环境变量 TANSHU_APPCODE", file=sys.stderr)
        sys.exit(1)

    url = "https://www.tanshuapi.com/market/detail-68"
    headers = {
        "Authorization": f"APPCODE {app_code}"
    }
    params = {
        "com": com,
        "no": no
    }

    try:
        resp = requests.get(url, headers=headers, params=params, timeout=5)
        resp.raise_for_status()
    except requests.RequestException as e:
        print(f"请求失败: {e}", file=sys.stderr)
        return {}

    return resp.json()

if __name__ == "__main__":
    result = query_express(com="zto", no="78792812069699")
    if not result:
        sys.exit(1)

    code = result.get("code")
    if code != 1:
        print(f"查询失败:{result.get('msg')}")
    else:
        data = result.get("data", {})
        print(f"快递公司:{data.get('company')}")
        print(f"当前状态:{data.get('status_desc')}")
        print("物流轨迹:")
        for item in data.get("list", []):
            print(f"{item['datetime']} - {item['remark']}")

三、常见问题处理

  1. 未知快递公司时怎么办?
    使用「单号识别快递公司」接口:

    jsdef identify_company(no: str) -> dict:
     url = "https://www.tanshuapi.com/market/detail-68"
     headers = {
         "Authorization": f"APPCODE {os.getenv('TANSHU_APPCODE')}"
     }
     params = {"no": no}
    
     try:
         resp = requests.get(url, headers=headers, params=params, timeout=5)
         resp.raise_for_status()
         return resp.json()
     except requests.RequestException as e:
         print(f"识别失败:{e}", file=sys.stderr)
         return {}
    
  2. 接口返回 403 错误?
    检查 TANSHU_APPCODE 是否正确配置
    确保账号已开通对应接口权限

四、总结
通过本文介绍的方法,你可以快速在 Python 中集成快递查询功能,满足电商、物流、客服等系统的实际需求。探数API 提供了稳定、高效、覆盖广泛的快递查询服务,开发者只需关注业务逻辑即可完成对接。

相关文章
|
5天前
|
JSON 前端开发 API
汽车配件:使用VIN码查询API精准匹配车型配件,提升用户信任
VIN码是汽车的唯一“身份证”,通过API可精准解析车型信息,实现配件99.5%以上匹配度。本文详解VIN码API的工作流程、技术实现与信任提升价值,助力汽配销售从经验判断迈向数据驱动,降低退货率,提升用户体验与复购。
103 0
|
5天前
|
JSON 安全 测试技术
医药电商:对接处方审核API实现线上购药合规化
医药电商需合规销售处方药。本文详解对接处方审核API,实现自动化真实性验证、用药合理性审查与全程留痕,满足监管要求。提升审核效率至3秒内,错误率低于0.5%,降低人力成本40%。构建审核闭环,保障安全与体验双赢。(238字)
103 0
|
7天前
|
监控 安全 API
什么是API?进行API对接的5大常见误区!
API是软件间通信的桥梁,API对接则实现系统间数据互通。广泛应用于内外部系统集成,提升效率、降低成本、增强竞争力。本文详解其概念、场景、方法及常见误区。
什么是API?进行API对接的5大常见误区!
|
7天前
|
JSON 监控 API
Shopee:对接海外仓API实现本地发货,优化物流时效
Shopee卖家可通过对接海外仓API实现本地发货,将物流时效从10-15天缩短至3-5天,显著提升买家体验与店铺转化率。本文详解API对接原理、步骤及代码示例,助力优化跨境物流效率。
43 1
|
7天前
|
数据采集 缓存 API
小红书笔记详情 API 实战指南:从开发对接、场景落地到收益挖掘(附避坑技巧)
本文详解小红书笔记详情API的开发对接、实战场景与收益模式,涵盖注册避坑、签名生成、数据解析全流程,并分享品牌营销、内容创作、SAAS工具等落地应用,助力开发者高效掘金“种草经济”。
小红书笔记详情 API 实战指南:从开发对接、场景落地到收益挖掘(附避坑技巧)
|
8天前
|
JSON 监控 API
小红书:对接苹果支付API满足iOS用户习惯,提升转化率
小红书集成Apple Pay可显著提升iOS用户支付体验,简化流程、增强安全、提高转化率。本文详解从开发配置、代码实现到后端验证与优化策略的全流程,助力高效落地,推动业务增长。(238字)
123 0
|
8天前
|
人工智能 API 开发工具
京东:对接白条API提供分期付款,降低消费门槛
本文详解京东白条API集成,涵盖技术原理、分步对接流程及Python代码实现,帮助开发者快速接入分期付款功能。通过API调用实现信用评估与分期计算,降低消费门槛,提升电商转化率。内容基于官方文档,确保准确可靠。
108 8
|
11天前
|
存储 监控 API
京东电子面单API对接指南:实现订单自动打单,发货效率提升300%
电子面单通过API自动化实现降本增效,显著提升订单处理效率。对接需准备app_key、access_token等参数,结合京东API实现快速打单。系统设计支持自动打印与异常告警,实测日均处理量提升316%,错单率大幅下降,人力成本节省超65%。
146 0
|
11天前
|
移动开发 算法 API
淘宝/天猫:使用物流查询API实时显示包裹位置,减少客服咨询量
电商平台中物流咨询占客服工作40%以上,用户频繁追问包裹位置。本文介绍通过物流查询API实现包裹实时追踪,降低75.6%咨询量,提升用户体验与复购率,助力降本增效。(238字)
146 0
|
14天前
|
JSON API 数据安全/隐私保护
Python采集淘宝评论API接口及JSON数据返回全流程指南
Python采集淘宝评论API接口及JSON数据返回全流程指南

热门文章

最新文章

推荐镜像

更多