指南
傳送第一個請求
建立工作空間 API 金鑰，用唯讀請求驗證接入。
點選端點可編輯請求並查看回應。
建立金鑰
開啟工作空間的 API 金鑰頁面，為你的應用建立金鑰。金鑰只展示一次，請立即儲存。
第一個請求只需要唯讀存取與 account:read。按需要新增權限，並設定到期時間、允許存取的 IP 範圍或支出限額。
確認工作空間
呼叫 GET/account 確認工作空間。在本機環境設定 MIGO_API_KEY，然後執行：
export MIGO_API_BASE='https://portal.migoip.com/api/customer/v1'
curl --fail-with-body "$MIGO_API_BASE/account" \
-H "Authorization: Bearer $MIGO_API_KEY"
成功回應會回傳金鑰所屬的工作空間。無需在請求中新增工作空間 ID，也不需要瀏覽器登入工作階段。
選擇權限
| 操作 | 權限 |
|---|---|
| 檢視靜態價格 | catalog:read |
| 檢視靜態資源 | proxies:read |
| 檢視連線憑證 | credentials:read 及對應代理權限 |
| 建立靜態訂單 | orders:write、wallet:spend |
| 購買動態流量 | dynamic:write、wallet:spend |
| 檢視動態設定和流量 | dynamic:read |
寫入操作還需要金鑰具有寫入存取權限。每個端點會列出完整的所需權限。新建唯讀金鑰預設不包含憑證讀取權限。
支出限額限制該金鑰累計從錢包扣除的金額，退款不會恢復限額。設定了支出限額的金鑰不能開啟自動續費。
妥善儲存金鑰
在伺服器或可信的本機工具中使用金鑰，不要寫入公開網站、程式碼儲存庫或共享記錄。金鑰遺失後，請撤銷並重新建立。