Skip to main content
GET
Get tracking
此页面由 AI 自动翻译。API 技术规格以英文呈现为标准。如有任何疑问,请参阅英文版本
此为 Enterprise 专属 功能,仅对 Return Helper Enterprise 客户开放。如需了解本服务的收费方式,请联系 enterprise-solution@returnhelper.com
返回 Return Helper 为您生成的退货面单的物流状态与事件记录。请将该面单的跟踪号作为 reference 传入。 跟踪号会通过面单生成 webhook 送达——请在面单创建时于您端保存该号码,之后即可随时调用本端点查询最新状态。

可查询的范围

跟踪功能覆盖以支持的服务类型创建的退货面单。若跟踪号来自其他服务类型,或来自本功能上线前创建的面单,会返回查无数据的错误,而不是空结果。

支持的服务类型

  • DHL_GERMANY
  • RETURN_DHL_ECOMMERCE_DEU
  • RETURN_DHL_ECOMMERCE_INTL_DEU
  • ROYAL_MAIL
  • RETURN_POSTMEN_RM_BIR
  • RETURN_RM48_QRCODE_BIR_GBR
  • FEDEX
  • fedex_ground
  • RETURN_FEDEX_GROUND_WA
  • RETURN_FEDEX_GROUND_USCA
  • RETURN_FEDEX_GROUND_TX
  • UPS
  • RETURN_UPS_SV_HKG

解读响应内容

所有时间戳均为 UTC 的 ISO 8601 格式。

状态值

message 是承运商提供的自由文本——可显示或记录,但请勿解析,也不要据此做分支判断。请改用 statusSlug 分支,并让无法识别的取值走默认分支,而不是直接失败。

错误

未提供或为空的 reference 会验证失败:HTTP 200meta.status400meta.errorCodeVALIDATION_FAILED,消息位于 meta.error.reference 其余所有失败都会返回 HTTP 200meta.status404meta.errorCodenull,并在 meta.error.message 中提供可读的消息:
  • 跟踪号不存在,或物流跟踪服务无法接受该值——消息会说明属于哪一种情况。
  • Tracking service is temporarily unavailable. —— 无法连接到物流跟踪服务。此时 reference 仍可能有效,请稍后重试。

授权

x-rr-apikey
string
header
必填

Your API key

x-rr-apitoken
string
header
必填

Your API token — keep this private

查询参数

reference
string
必填

Tracking number of a return label generated by Return Helper.

响应

Success — data carries the tracking detail. events is an empty list when the carrier has not reported anything yet.

data
object