TrackingMore API

API key

為了使用這個API,您將需要生成壹個TrackingMore API 密鑰 API Keys.申請免費使用 API.

The base URL

http://api.trackingmore.com/v2

Header

In order to verify and authenticate your application (e.g. your site), all of the requests that you make to the API must include your unique TrackingMore API Key header (Trackingmore-Api-Key), which you can generate and/or find in the TrackingMore Panel.

Content-Type: application/json
Trackingmore-Api-Key: YOUR_API_KEY

跟蹤狀態清單

StringDescription
pending新增包裹正在查詢中,請等待!
notfound包裹目前查詢不到。
transit包裹正從發件國運往目的國。
pickup包裹正在派送中或已到達當地收發點,妳可以繼續派送或收件。
delivered包裹已成功妥投。
undelivered快遞員嘗試過投遞但失敗,(這種情況下)通常會留有通知並且會再次試投!
exception包裹出現異常,發生這種情況可能是:包裹已退回寄件人,清關失敗,包裹已丟失或損壞等。
expired包裹很長壹段時間顯示在運輸途中,壹直沒有派送結果。

典型的伺服器回應

我們將回應以下狀態碼。

CodeDescription
200OK - 請求已成功 (一些 API 呼叫可能會相反返回 201)。
201Created - 請求成功,已創建了資源。
202Created - 請求已成功,但超過了數量限制。
401Unauthorized - 身份驗證失敗或使用者沒有所請求的操作的許可權。
4001Unauthorized - 不正確 API 金鑰。
4002Unauthorized - API 金鑰已被刪除。
4012Bad Request - 請求不能理解或缺少必需的參數。
4013Bad Request - Tracking_number 是必需的。
4014Bad Request - 'Tracking_number' 的值是不正確。
4015Bad Request - 'Carrier_code' 的值是不正確。
4016Bad Request - 跟蹤已存在。
4017Bad Request - 跟蹤並不存在。
4018Bad Request - 由於超載風險此功能需要自訂啟動。與 [email protected] 聯繫更多的資訊。
4020Bad Request - 數量限制壹次 200。
4021Bad Request - 妳的余額不夠,所以妳不能調用API請求數據。
4031No Content - 請求已成功,但回應為空。
4032No Content - 無法檢測到快遞。
402Payment Required - 付款要求。
403Forbidden - 訪問被拒絕。
404Not Found - 找不到資源。
405Method Not Allowed - 指定的資源不支援請求的方法。
409Conflict - 由於衝突,無法完成請求。
429Too Many Requests - 超過 API 限制。請求暫停,等待兩分鐘,然後再試。
500Server error
503Service Unavailable - 服務是臨時不可用 (例如預定的平臺維護)。稍後再試。

請求速率限制

我們對請求次數做了限制。注意:超出此限制將收到“429錯誤”提示.

  • 實時查詢,每個IP每秒最多3次請求。

  • 列出所有的跟蹤,每個IP壹秒壹次請求,每次最多2000條跟蹤項目。