name: realtime-express-tracking description: 实时快递查询,支持获取快递公司列表和查询快递物流轨迹。需要查快递、物流跟踪时使用。 license: MIT
能力概述
本 skill 封装了两个快递相关接口,通过百度云 API 网关(app-bo4w33bsdqm9-api-V9gDz8wo0V5L-gateway.appmiaoda.com)提供服务:
| 接口 | Endpoint | 方法 | 说明 |
|---|---|---|---|
| 快递公司列表获取 | GET /getExpressList |
GET | 获取所有支持的快递公司名称及简码,支持按简码筛选 |
| 快递物流轨迹查询 | GET /kdi |
GET | 查询指定快递单号的实时物流轨迹、投递状态等详细数据 |
支持近百家国内外快递公司,包括顺丰、申通、中通、圆通、韵达、EMS 等。
平台差异: 两个接口均返回 JSON 数据,Web 和 MiniProgram 平台实现一致,均通过 Edge Function 中转。
生成期用法(Agent 直接调用)
认证方式:platform_managed,密钥通过 INTEGRATIONS_API_KEY 环境变量注入,Auth Header 统一使用 X-Gateway-Authorization: Bearer ${apiKey}。
详见:
references/get-express-list-api.md— 快递公司列表获取接口的完整规范与生成期代码references/kdi-api.md— 快递物流轨迹查询接口的完整规范与生成期代码
生成后用法(应用内通过 Edge Function 调用)
两个接口各自部署为独立 Edge Function,客户端通过 supabase.functions.invoke 调用,密钥由 Edge Function 从 INTEGRATIONS_API_KEY 读取,不暴露给前端。
| 接口 | Edge Function 名称 | 适用平台 |
|---|---|---|
| 快递公司列表获取 | get-express-list |
Web、MiniProgram |
| 快递物流轨迹查询 | kdi-query |
Web、MiniProgram |
详见:
references/get-express-list-api.md— Edge Function 完整代码 + 前端调用示例references/kdi-api.md— Edge Function 完整代码 + 前端调用示例(含顺丰特殊规则处理)