购买与续费静态代理

选择位置和期限

使用 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 参考。