POSTexpress-query-v2
快遞單號查詢
提供快遞單號查詢 API 服務,便於開發者快速查詢快遞單號相關資訊並整合至業務系統。
接入文件
快遞單號查詢介面說明
快遞單號查詢 API 用於協助開發者在系統中快速完成快遞單號查詢相關處理,返回結構化結果,適合物流追蹤、訂單查詢、客戶通知等場景。
適用場景
- 支援將快遞單號查詢能力接入內部系統、SaaS 平台、自動化工作流程或營運後台。
- 適合需要穩定呼叫、標準化返回和可編排介面能力的業務場景。
- 建議結合請求頻率控制、失敗重試和結果快取策略,提升整體接入穩定性。
接入建議
- 接入前確認請求參數格式、驗證方式和錯誤碼處理邏輯。
- 對高頻查詢場景建議做好日誌追蹤、超時控制和冪等處理。
- 如結果用於風控或自動決策,建議結合業務規則進行二次判斷,而不是直接單點依賴介面返回。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例,便於直接接到現有專案裡。
請求示例
{
"expCode": "shunfeng",
"expNo": "SF1234567890"
}響應示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"status": "已签收",
"statusDesc": "快件已签收",
"traces": [
{
"time": "2024-01-01 10:00:00",
"desc": "已签收"
}
]
}
}請求欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| expCode | string | shunfeng |
| expNo | string | SF1234567890 |
響應欄位
以下欄位根據示例 JSON 自動提取,僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.status | string | 已签收 |
| data.statusDesc | string | 快件已签收 |
| data.traces | array | {"time":"2024-01-01 10:00:00","desc":"已签收"} |