指南

流量與帳單

購買流量、檢視餘額，並跟蹤錢包記錄。

點選端點可編輯請求並查看回應。

區分兩種餘額

標準流量用於動態代理請求。最佳化流量是最佳化動態連線額外使用的額度。最佳化請求會同時消耗兩種餘額。

讀取 GET/dynamic/account 獲取餘額快照。標準流量的 total_bytes、used_bytes 和 remaining_bytes 來自同一份報告。null 表示資料暫不可用。不同報告可能在不同時間更新。

GET/dynamic/usage 用於分析指定時段的活動。剩餘額度請讀取 GET/dynamic/account 的 remaining_bytes。

購買流量包

讀取 GET/dynamic/config，選擇可用流量包。將其編號作為 pack_id 呼叫 POST/dynamic/quotes，確認報價後再購買。

呼叫 POST/dynamic/purchases，將 QUOTE_ID 設為回傳的報價編號，並儲存請求識別碼：

PURCHASE_REQUEST_KEY=$(uuidgen)

curl --fail-with-body "$MIGO_API_BASE/dynamic/purchases" \
  -H "Authorization: Bearer $MIGO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $PURCHASE_REQUEST_KEY" \
  -d "{\"quote_id\":\"$QUOTE_ID\"}"

此操作需要寫入存取權限、dynamic:write 和 wallet:spend。透過 GET/dynamic/purchases/{id} 跟蹤購買結果。已受理不一定表示流量已就緒。

如果啟用失敗或結果不確定，請保留購買編號並聯系支援。不要再次購買來恢復原訂單。詳見錯誤與重試。

為錢包充值

你可以直接在工作空間的錢包充值。API 接入可先讀取 GET/recharges/config，再建立和跟蹤支付。

建立支付不等於錢包入帳，付款確認後才會增加餘額。支付方式與限額以工作空間配置為準。

檢視記錄

GET/wallet/summary 提供彙總，GET/wallet/ledger 提供已入帳流水，GET/order-history 彙總購買記錄。大多數列表使用 page 和 page_size 分頁，具體限制見API 參考。