購買與續費靜態代理

選擇位置和期限

使用 catalog:read 呼叫 GET/catalog↗，選擇符合位置和期限的報價項，將回傳的 id 用作 price_id，不要自行拼接。

價格與可用性以工作空間為準。請選擇目錄傳回的位置報價項目。按月計費的期限使用自然月。

獲取報價

呼叫 POST/quotes↗，將 PRICE_ID 設為所選報價項編號。API 地址與金鑰配置見開始使用。

curl --fail-with-body "$MIGO_API_BASE/quotes" \
  -H "Authorization: Bearer $MIGO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "{\"price_id\":\"$PRICE_ID\",\"quantity\":1,\"protocol\":\"http\",\"access_optimized\":false}"

檢查回應中的 total_fen。金額以人民幣分的整數字串回傳，例如 "100" 表示 1 元。獲取報價不會扣款。

確認訂單

呼叫 POST/orders↗，將 QUOTE_ID 設為回傳的報價編號。為本次訂單建立一個請求識別碼並儲存：

ORDER_REQUEST_KEY=$(uuidgen)

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

此操作從錢包扣款，需要 orders:write、wallet:spend 和寫入存取權限。回應遺失時，使用原請求體和已儲存的識別碼重試，不要重新產生識別碼。

等待連線就緒

202 表示訂單已受理。透過 GET/operations/{id}↗ 或 GET/orders/{id}↗ 檢視進度。就緒後，讀取 GET/proxies/{id}↗ 獲取憑證，並按連線指南接入。

續費或新增最佳化

使用例項回傳的續費價格，先呼叫 POST/proxies/{id}/renewal-quotes↗，再透過 POST/proxies/{id}/renewals↗ 確認，並儲存冪等識別碼。請在到期前續費；此流程不能恢復已過期資源。

多個例項可使用批次續費端點。為現有 IP 新增最佳化時，呼叫 POST/proxies/{id}/optimization-quotes↗，再透過 POST/orders↗ 確認。完整欄位見API 參考。