寧靜的包裝跟蹤 API-TrackingMore

TrackingMore API

Get API key

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

The base URL

https://api.trackingmore.com/v2

Note : "http" is also supported.

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 API Keys.

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

跟蹤狀態清單

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

Notfound SubStatus	Description
`not found001`	待攬件，只有壹條訂單生成的信息。
`not found002`	完全無信息。

Exception SubStatus	Description
`exception001`	發貨無信息。
`exception002`	超時無更新。
`exception003`	超時未簽收。
`exception004`	超時未自提。
`exception005`	退回件。
`exception006`	海關扣留。
`exception007`	包裹破損。
`exception008`	未攬收被取消。

Tips
The first three kinds of "exception" are marked because the users set their own "exception" rules on the background here: https://my.trackingmore.com/set_couriers.php?lang=en

API 參數返回清單

參數	Description
`code`	元代碼
`type`	元類型
`message`	元狀態原因
`id`	Trackingmore 生成的亂數據來識別跟蹤
`tracking_number`	包跟蹤編號
`carrier_code`	快遞代碼
`status`	包狀態
`created_at`	添加跟蹤編號的時間
`updated_at`	更新跟蹤編號的最新時間
`order_create_time`	創建訂單的時間
`title`	產品名稱
`order_id`	訂單 ID
`comment`	你對裝運的評論
`customer_name`	客戶名稱
`customer_email`	客戶郵箱
`original_country`	原產地國家名稱
`singed_by`	收件者姓名
`lastEvent`	最新跟蹤資訊
`lastUpdateTime`	最新跟蹤資訊的時間
`destination_country`	原產地國家名稱
`itemTimeLength`	裝運的運輸時間
`stayTimeLength`	自上次跟蹤資訊出現以來的總天數沒有更新
`origin_info`	追蹤資訊從來源信使
`ItemReceived`	出現第一個跟蹤資訊的時間
`ItemDispatched`	離職時間從對外交流辦公室
`DepartfromAirport`	抵達機場的時間
`ArrivalfromAbroad`	到達目的地國的時間
`CustomsClearance`	包裹被移交給海關的時間
`DestinationArrived`	到達交貨處的時間
`weblink`	快遞官方網站連結
`phone`	快遞電話號碼
`trackinfo`	包跟蹤資訊的詳細資訊
`Date`	特定跟蹤資訊的時間
`StatusDescription`	一條跟蹤資訊的主要內容
`Details`	位置資訊出現在特定的跟蹤資訊片斷中
`destination_info`	從目標信使跟蹤資訊

典型的伺服器回應

我們將回應以下狀態碼。

Meta.code	Meta.type	消息
200	`Success`	請求成功。
201	`Created`	請求成功，此單號曾添加過壹次。
202	`Bad Request`	請求成功，但請求數量超過限制。
401	`Unauthorized`	身份驗證失敗或使用者沒有所請求的操作的許可權。
4001	`Unauthorized`	不正確 API 金鑰。檢查 API調用說明
4002	`Unauthorized`	API 金鑰已被刪除。檢查 API調用說明
4012	`Bad Request`	請求不能理解或缺少必需的參數。
4013	`Bad Request`	Tracking_number 快遞單號是必傳參數。
4014	`Bad Request`	Tracking_number 快遞單號格式錯誤。
4015	`Bad Request`	'Carrier_code' 的值是不正確。檢查快遞代碼
4016	`Bad Request`	快遞單號已存在。
4017	`Bad Request`	快遞單號不存在。
4018	`Bad Request`	由於超載風險此功能需要自訂啟動。與 [email protected] 聯繫更多的資訊。
4019	`Bad Request`	您的餘額不足,請及時充值
4020	`Bad Request`	數量限制壹次 200。
4021	`Bad Request`	妳的余額不夠,所以妳不能調用API請求數據。購買這裡
4031	`No Content`	您還未添加此單號，請先使用Post接口創建單號，然後再調用Get接口獲取物流信息。請嘗試 POST /trackings/post 然後 GET /trackings/get
4032	`No Content`	無法檢測到快遞運輸商。請給快遞單號指定相應運輸商簡碼來查詢信息。獲取快遞代碼
4033	`No Content`	"狀態" 的值無效。
402	`Payment Required`	付款要求。
403	`Forbidden`	訪問被拒絕。
404	`Not Found`	找不到資源。
405	`Method Not Allowed`	指定的資源不支援請求的方法。
409	`Conflict`	由於衝突，無法完成請求。
429	`Too Many Requests`	超過 API 限制。請求暫停，等待兩分鐘，然後再試。
500	`Server error`
503	`Service Unavailable`	服務是臨時不可用（例如預定的平臺維護）。稍後再試。

請求速率限制

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

POST /trackings/realtime 實時查詢接口，每個賬戶每秒最多3次請求。
GET /trackings/get 接口，每個賬戶每秒最多1次請求，每次最多2000個單號。