Universal Parcel Tracking API

Real-time global package tracking API. Auto-detects 1,500+ couriers worldwide (DHL, FedEx, UPS, USPS, China Post, etc.). Standardized JSON responses for E-commerce, Dropshipping, and Logistics apps.Real-time global package tracking API. Auto-detects 1,500+ couriers worldwide (DHL, FedEx, UPS, USPS, China Post, etc.). Standardized JSON responses for E-commerce, Dropshipping, and Logistics apps.

原始信息汇总

Universal Parcel Tracking API 数据集概述

基本信息

• API名称：Universal Parcel Tracking API
• 类别：Logistics
• 提供商：1TimeTech
• 当前版本：v1
• 订阅计划：
  • BASIC：$5.00 / mo
  • PRO：$20.00 / mo
  • ULTRA：$50.00 / mo
  • MEGA：$0.00 / ---
• 性能指标：
  • 流行度：8.9
  • 服务等级：100%
  • 延迟：347ms
  • 测试通过率：100%

核心功能

• 全球覆盖：支持全球超过1,500家快递公司，包括DHL、FedEx、UPS、USPS、China Post、Royal Mail等主要及本地承运商。
• 智能自动检测：仅需提供追踪号码，系统即可高精度自动识别正确的承运商。
• 实时更新：直接从承运商官方来源获取最新的追踪状态。
• 标准化状态：将复杂的承运商状态规范化为简单的通用检查点（例如Pending、In Transit、Out for Delivery、Delivered、Exception、Returned）。
• 高性能：基于稳健的基础设施构建，确保99.9%的正常运行时间和低延迟。
• 开发者友好：采用清晰、易于理解的RESTful架构，提供标准化的JSON响应。

适用场景

• 电子商务平台：为Shopify、WooCommerce或Magento商店添加实时追踪页面。
• 代发货业务：自动监控数百个AliExpress或CJ Dropshipping订单。
• 物流与ERP系统：将货运可视性直接集成到内部仪表板中。
• 消费者应用程序：为iOS或Android构建下一个热门包裹追踪应用。

端点与使用方法

主要端点

• HTTP请求：GET /track
• 功能：检索特定包裹的实时追踪更新、多程承运商详情和预计到达时间（ETA）。

查询参数

参数名	类型	是否必需	描述
trackingNumber	string	是	包裹的追踪号码（例如YT2607201001591020）。
carrier	string	否	可选。用于绕过自动检测的特定承运商代码（例如yun-express）。

身份验证

• 通过RapidAPI代理自动处理。
• 每个请求必须包含以下请求头：
  • X-RapidAPI-Key：您唯一的RapidAPI API密钥。
  • X-RapidAPI-Host：RapidAPI提供的主机域（例如universal-parcel-tracking.p.rapidapi.com）。

响应结构

API返回一个全面的标准化JSON对象，关键数据点包括：

• ok：请求成功为true，否则为false。
• data.carriers：涉及运输的所有承运商数组（支持多程路由）。
• data.next_tracking_ids：最后一程承运商使用的追踪号码。
• data.status：规范化的全局追踪状态（例如transit、delivered、exception、not_found）。
• data.eta：智能交付预估，提供最小/最大日期和剩余天数。
• data.tracking_history：所有涉及承运商扫描事件的按时间顺序列表。

错误处理

常见HTTP状态码：

• 200 OK：请求成功。
• 400 Bad Request：缺少必需参数（例如trackingNumber）。
• 401 Unauthorized：RapidAPI密钥无效或缺失。
• 404 Not Found：在承运商系统中未找到追踪号码。
• 429 Too Many Requests：超出计划速率限制。
• 500 Internal Server Error：服务器端发生错误。

错误响应示例： json { "ok": false, "error": { "code": "tracking_not_found", "message": "The tracking number could not be found. Please check the number and try again." } }