API
51Tracking提供API接口及相關(guān)功能，接口速率、類型、及調(diào)用步驟請?zhí)D(zhuǎn)至相應(yīng)的Api文檔進行查看。強烈推薦您使用V4版本，支持了更多的字段信息，優(yōu)化了報文結(jié)構(gòu)，提供了UTC時間格式。V4版本不向下兼容，但您任可以使用V2以及V3版本。在不久的將來我們將會停用V2 V3版本，屆時會通過郵件&短信進行告知。 請注意API的調(diào)用為一項付費功能，我們?yōu)樾掠脩籼峁┳云馂槠?天的免費試用。試用期過后，升級您的賬戶即可繼續(xù)使用該功能。
如何使用Webhook
【開發(fā)者中心】→【W(wǎng)ebhook】 您需要提供一個允許公網(wǎng)訪問的API接口地址，用于接收物流軌跡信息推送我們系統(tǒng)會默認(rèn)一個單號物流軌跡推送給您進行接收測試當(dāng)您保存webhook地址以及版本之后，會出現(xiàn)可以選擇具體物流軌跡推送的節(jié)點一個賬號只能有一個Webhook URL，保留3天內(nèi)的推送記錄
API調(diào)用步驟
1.創(chuàng)建單號：調(diào)用「添加物流單號」接口POST 2.獲取結(jié)果調(diào)用「 獲取查詢結(jié)果」接口GET（最多一次請求，一次請求最多2000個單號）
獲取API Key
進入51用戶后臺，選擇「開發(fā)者中心」 → 「API Key調(diào)試」，復(fù)制你的API Key。 Tips：獲取 API Key 之后，請妥善保管你的 API Key，不要將其分享到網(wǎng)站上，這可能導(dǎo)致 API Key 被他人使用而造成損失。
V3版本 Webhook 簽名驗證
為了確保消息的來源身份是 51tracking，你可以選擇對 POST 數(shù)據(jù)的來源進行安全認(rèn)證。 ( 不驗證，直接解析 POST 的數(shù)據(jù)也可以 ) 安全認(rèn)證的方法如下： 解析出 POST 數(shù)據(jù)中的 timestamp 和 signature 這兩個參數(shù)。 使用你的 51tracking 用戶郵箱(密鑰) 和 timestamp (明文) 生成簽名 signature, 與 POST 數(shù)據(jù)中的 signature 進行校驗 ( 簽名算法: PHP：SHA256、JAVA：HmacSHA256) 備注:使用附帶的Jave和Php示例代碼來驗證51Tracking數(shù)據(jù)，當(dāng)驗證您自己的數(shù)據(jù)請?zhí)鎿QSIGNATURE，TIMESTAMP 和 ACCOUNT。 Javaimport javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import java.security.InvalidKeyException; import java.security.NoSuchAlgorithmException; public class Main { public static void main(String[] args) throws NoSuchAlgorithmException, InvalidKeyException { String signature = \"0d90bb874fed0b056d8b3aa794529ebacd49932a0cea691629b63eaf2ca9d400\"; String timestamp = \"1653632765\"; String account = \"info@trackingmore.org\"; Mac sha256_HMAC = Mac.getInstance(\"HmacSHA256\"); SecretKeySpec secret_key = new SecretKeySpec(account.getBytes(), \"HmacSHA256\"); sha256_HMAC.init(secret_key); byte[] bytes = sha256_HMAC.doFinal(timestamp.getBytes()); StringBuilder new_signature = new StringBuilder(); for (byte item : bytes) { new_signature.append(Integer.toHexString((item & 0xFF) | 0x100).substring(1, 3)); } System.out.println(new_signature.toString()); System.out.println(new_signature.toString().equals(signature)); } } Php$signature = \'0d90bb874fed0b056d8b3aa794529ebacd49932a0cea691629b63eaf2ca9d400\'; $timestamp = \'1653632765\'; $account = \'info@trackingmore.org\'; $new_signature = hash_hmac(\'sha256\', $timestamp, $account); var_dump($signature == $new_signature , $new_signature); * V2與V3版本的簽名是 郵箱+時間戳 的加密方式，如果您變更了您的賬戶郵箱，需要更改簽名使用的郵箱。V4版本中使用的是 APIKey+時間戳 的加密方式，所以不存在此問題。
API在線調(diào)試
1.開始調(diào)試【開發(fā)者中心】→【API密匙】→【在線調(diào)試】 2.創(chuàng)建單號流程注：創(chuàng)建會消耗您的單號額度，創(chuàng)建后需等待一些時間查詢物流軌跡，否則單號狀態(tài)為查詢中，無法獲取到物流軌跡 第一步：需先選擇 /v3/trackings/create 接口，創(chuàng)建運單號，如果您配置了 Webhooks，當(dāng)獲取到物流軌跡后，將會通知到您的系統(tǒng) 第二步：選擇 /v3/trackings/get 接口，獲取第一步添加運單號物流軌跡
查物流軌跡，就用51Tracking
粵公網(wǎng)安備 44030402004175號