{
  // 快递单号
  "tracking_number": "YT1234567890123",
  // 快递公司编码
  "carrier_code": "yuantong",
  // 快递公司名称
  "carrier_name": "圆通速递",
  // 物流轨迹数量
  "track_count": 3,
  // 快递是否已完成。仅当状态识别为已签收/已妥投/已完成时为 true。
  "is_completed": true,
  // 完成时间。仅已完成时返回签收或妥投对应的轨迹时间；未完成时为空字符串。
  "completed_at": "2025-10-27 15:30:00",
  // 快递状态中文名称，例如：待揽收、已揽收、运输中、派送中、已完成、异常、未知。
  "status": "已完成",
  // 快递状态编码。可能值：pending、picked_up、in_transit、out_for_delivery、delivered、exception、unknown。
  "status_code": "delivered",
  // 物流轨迹列表，按时间倒序排列
  "tracks": [
    {
      // 物流更新时间
      "time": "2025-10-27 15:30:00",
      // 物流状态描述
      "context": "快件已签收，感谢使用圆通速递"
    }
  ]
}

{
  "code": "INVALID_ARGUMENT",
  "message": "缺少快递单号参数"
}

{
  "code": "NO_TRACKING_DATA",
  "message": "暂无物流信息"
}