# 购买与续费静态代理

选择位置和期限，确认报价，再获取固定 IP 的连接信息。

## 选择位置和期限

使用 `catalog:read` 调用 `GET /catalog`，选择符合位置和期限的报价项，将返回的 `id` 用作 `price_id`，不要自行拼接。

价格与可用性以工作空间为准。请选择目录返回的位置报价项。按月计费的期限使用自然月。

## 获取报价

调用 `POST /quotes`，将 `PRICE_ID` 设为所选报价项编号。API 地址与密钥配置见[开始使用](/zh-cn/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-cn/docs/guides/connections)接入。

## 续费或添加优化

使用实例返回的续费价格，先调用 `POST /proxies/{id}/renewal-quotes`，再通过 `POST /proxies/{id}/renewals` 确认，并保存幂等标识。请在到期前续费；此流程不能恢复已过期资源。

多个实例可使用批量续费接口。为现有 IP 添加优化时，调用 `POST /proxies/{id}/optimization-quotes`，再通过 `POST /orders` 确认。完整字段见[API 参考](/zh-cn/docs/api)。