步驟 1 — 建立經過驗證的帳戶
使用 Česká pošta 註冊連結 註冊 Zonos 經過驗證的帳戶。 完成您的商務地址和帳單設定。
步驟 2 — 新增付款方式
在您的 Zonos 帳戶中新增付款方式，以便為往美國的出貨金流進行關稅匯款。
步驟 3 — 取得您的 API 金鑰
登入您的 Zonos Dashboard 並瀏覽至 帳戶 → 整合。該表格顯示兩個金鑰：
| Dashboard 中的名稱↕ | 用途↕ | 用於 API？↕ |
|---|---|---|
| 帳戶金鑰 | 用於與郵政運營商連結的識別碼 | ❌ 否 |
| API 金鑰 | 用於呼叫 Zonos API 的驗證金鑰 | ✅ 是 — 使用此金鑰 |
複製 API 金鑰 列中的權杖。它以 credential_live_ 開頭。您需要此
金鑰才能進行兩種整合方法。
保護您的 API 金鑰安全。請勿將其提交至原始碼控制或公開分享。如果 您認為它已被洩露，請從同一個 帳戶 → 整合 頁面重新產生。
步驟 4 (選用) — 使用 Item Quoter 估算關稅成本
您的 Zonos Dashboard 中的 Item Quoter 工具可讓您在出貨前查詢產品的估算關稅成本 — 對於檢查費率和提前規劃非常有用，無需產生 Declaration ID。
整合方法
選擇適合您技術設定的方法。兩種方法都會產生 Declaration ID，然後您 將其上傳至 Česká pošta 的運送系統。
適用於直接呼叫 Zonos 的技術客戶和開發人員。
端點
- URL：
https://api.zonos.com/graphql - 方法：POST
- Content-Type：
application/json
驗證
在 credentialToken 標題中傳遞您的 API 金鑰：
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
API 範例
登入您的 Česká pošta 帳戶，以取得完整的 API 範例，包括完整的請求和 回應。
產生 Declaration ID 之後
將 Declaration ID 連同您的出貨詳情提交至 Česká pošta。Česká pošta 會將 Declaration ID 連結至出貨並傳回追蹤號碼。Zonos 不發行追蹤號碼。
錯誤處理
| 錯誤 / 症狀↕ | 可能的原因和解決方案↕ |
|---|---|
| 安全要求失敗 | 您的 API 金鑰無效或在錯誤的標題中傳遞。請確保您使用的是 API 金鑰 (而非帳戶金鑰)，且標題名稱完全是 credentialToken。 |
| HTTP 401 未授權 | API 金鑰在請求標題中缺失。確認 credentialToken 已包含。 |
回應中的 errors 陣列 | 此突變傳回 GraphQL 錯誤。檢查錯誤陣列中 message 欄位的詳細資訊。 |
| 意外的回應形式 | 回應不包含 data.declarationCreate.id。記錄完整回應本文，並確認突變文字與範例完全相符。 |
帳戶設定
建立經過驗證的帳戶，新增付款方式，並連接您的整合。