核心用法
快递100技能提供一站式物流信息查询服务,支持五大核心功能:
| 功能 | 用途 | 典型场景 |
|:---|:---|:---|
| `query_trace` | 查物流轨迹 | "我的快递到哪了" |
| `auto_number` | 识别快递公司 | "这是什么快递" |
| `estimate_price` | 估算运费 | "寄到XX多少钱" |
| `estimate_time` | 预估寄件时效 | "几天能到" |
| `estimate_time_with_logistic` | 预估在途剩余时间 | "还要多久到" |
调用方式:通过 curl 直连 api.kuaidi100.com/stdio,支持30+主流快递公司(顺丰、京东、中通、圆通、韵达、EMS、德邦等)。
关键特性:
- 顺丰、中通等需手机号验证,自动处理参数透传
- 智能识别快递公司编码,无需用户手动填写
- 支持复杂地址解析与重量运费计算
显著优点
1. 官方数据源:快递100为行业头部物流信息平台,接口覆盖国内绝大多数快递企业
2. 功能闭环:从"查单号→认快递→估运费→预测时效"形成完整决策链
3. 零配置门槛:未设置 KUAIDI100_API_KEY 时自动使用免费额度,开箱即用
潜在局限
| 问题 | 说明 |
|:---|:---|
| **免费额度限制** | 每日免费调用次数有限,耗尽后需自行注册获取 API Key |
| **数据实时性** | 物流轨迹依赖快递公司回传,极端情况下存在 1-6 小时延迟 |
| **国际件支持弱** | 仅支持 EMS-国际件、国际包裹等少数国际线路,海外快递覆盖不足 |
| **企业版功能缺失** | 批量查询、电子面单、签收图片等企业级功能未开放 |
适合人群
- 个人用户:日常查快递、比价寄件、追踪包裹
- 小微商家:发货前运费估算、时效承诺参考
- 开发者:快速集成物流查询能力的原型项目
常规风险
- 隐私合规:查询顺丰等需手机号,存在个人信息透传风险
- 额度中断:高峰期免费额度易耗尽,生产环境建议配置专属 Key
- 地址解析误差:模糊地址(如"高新区")可能导致运费/时效计算偏差
---
> 使用建议:日常查询完全够用;高频调用或商业场景务必前往 快递100开放平台 申请独立 API Key。