# 購買與續費靜態代理

選擇位置和期限，確認報價，再獲取固定 IP 的連線資訊。

## 選擇位置和期限

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

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

## 獲取報價

呼叫 `POST /quotes`，將 `PRICE_ID` 設為所選報價項編號。API 地址與金鑰配置見[開始使用](/zh-tw/docs/guides/getting-started)。

```sh
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` 設為回傳的報價編號。為本次訂單建立一個請求識別碼並儲存：

```sh
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}` 獲取憑證，並按[連線指南](/zh-tw/docs/guides/connections)接入。

## 續費或新增最佳化

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

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