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每秒一次請求,每次最多200條跟蹤項目。

API 呼叫的多語言內容

目前支持的 API 調用官方多語言運輸商列表.

快遞簡碼 快遞名稱
139express 139 ECONOMIC Package
17postservice 17 Post Service
acscourier ACS Courier
adicional Adicional Logistics
aramex Aramex
armenia-post Armenia post
asendia-de Asendia Germany
austria-post Austrian Post
azerbaijan-post Azerbaijan post
bartolini BRT Bartolini
belgium-post Belgium post
belpochta Belarus post
bosnia-and-herzegovina-post Bosnia and Herzegovina post
brazil-correios Brazil Correios
canada-post Canada post
canpar Canpar Courier
china-ems China EMS
chronopost France EMS - Chronopost
cnexps CNE Express
colissimo French Post - Colissimo
correo-argentino Argentina post
correos-bolivia Bolivia post
correos-spain correos
ctt Portugal post - CTT
czech-post Česká Pošta
denmark-post Denmark post
dhl DHL
dhl-active DHL Active Tracing
dhl-es DHL Spain Domestic
dhl-germany Deutsche Post DHL
dhl-poland DHL Poland Domestic
dhlglobalmail DHL eCommerce
dhlparcel-nl DHL Parcel Netherlands
dpd DPD
ecargo-asia Ecargo
emirates-post Emirates Post
fedex Fedex
finland-posti Finland post - Posti
georgian-post Georgia post
gls GLS
gls-italy GLS Italy
greece-post ELTA Hellenic Post
hong-kong-post Hong Kong Post
iceland-post Iceland post
israel-post Israel post
israel-post Israel post
japan-post Japan post
jcex JCEX
kazpost Kazakhstan post
kerry-logistics Kerry Express
korea-post Korea Post
kyrgyzpost Kyrgyzstan post
latvijas-pasts Latvia post
lietuvos-pastas Lithuania post
luxembourg-post Luxembourg post
macao-post Macao Post
malaysia-post Malaysia post
matkahuolto Matkahuolto
moldova-post Moldova post
omniva Estonia post
pfcexpress PFC Express
poczta-polska Poland post
posten-norge Posten Norge
purolator Purolator
saudi-post Saudi Post
serbia-post Serbia post
sf-express S.F Express
sfb2c S.F International
sfcservice SFC Service
sfcservice SFC Service
slovakia-post Slovakia post
sweden-posten Sweden Posten
swiss-post Swiss Post
taqbin-jp Yamato Japan
taxydromiki Geniki Taxydromiki
tnt TNT
tunisia-post Tunisia post
turkey-post Turkey post
ups UPS
vietnam-post Vietnam post
wishpost WishPost
yanwen YANWEN