TrackingMore API

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未攬收被取消。

API 參數返回清單

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

請求速率限制

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

  • POST /trackings/realtime        實時查詢接口,每個賬戶每秒最多3次請求。
  • GET /trackings/get                    接口,每個賬戶每秒最多1次請求,每次最多2000個單號。
  • Facebook Twitter Android App Store
  • ©2014-2019 TrackingMore.All Rights Reserved.