身分驗證

身分驗證

透過 HTTPS 傳送 JSON 請求，在 X-API-Key 提供完整 API 金鑰。金鑰只儲存在伺服器端，不放入瀏覽器程式碼、行動應用程式、原始碼儲存庫或日誌。不需傳送 App 登入 token、Bearer token 或另一份 API secret；這些端點僅使用 X-API-Key 驗證。目前不提供 OAuth 接入。

請求標頭

Content-Type: application/json
X-API-Key: <your-api-key>

金鑰儲存與管理

新金鑰只在建立或輪換成功時完整顯示一次，清單僅顯示遮罩識別碼。遺失後無法找回，請更換並撤銷無法使用的金鑰；新金鑰不會自動取得更大的權限。

新金鑰預設有效期為 365 天，也可選擇其他未來到期時間或永久。永久金鑰仍可暫停、撤銷。請在 API Keys 檢查到期時間；自動到期提醒尚未開放。

暫停可恢復，撤銷不可恢復。輪換產生權限相同的新金鑰，請在舊金鑰的重疊期限內完成切換。預設重疊 24 小時，最長 7 天，也可立即撤銷舊金鑰。

權限

查詢運費

labels.read or labels.buy

購買面單

labels.buy

申請取消面單

labels.buy

這三個相容端點保留原權限規則：labels.read 或 labels.buy 可查價；labels.buy 同時允許購買和取消面單。規劃中的 labels.void 等新權限不會取代或擴大這些授權，舊金鑰也不會自動取得新 scope 或新資源權限。目前僅可使用現有端點的 Live 金鑰，新資源權限契約與測試金鑰尚未開放。

回傳結果

Responses use { code, message, data }. Check both the HTTP status and response code; provider errors are not successful purchases.