POST /proxies/buy

Покупка прокси. Средства списываются с баланса.

Запрос

POST /proxies/buy

Scope: proxies:write

Тело запроса (JSON)

Поле	Тип	Обязательный	По умолчанию	Описание
`country`	string	да	—	ISO2-код страны (2-4 символа)
`period`	integer	да	—	Срок аренды в днях
`count`	integer	нет	`1`	Количество прокси (1–1000)
`version`	string	нет	`"6"`	Версия IP: `6`, `4` или `4s`
`proxy_type`	string	нет	`"http"`	Протокол: `http` или `socks`

Минимальные периоды

Версия	Минимальный период
IPv6	3 дня
IPv4	7 дней
IPv4s	7 дней

Пример

2 IPv6 HTTP-прокси в России на 30 дней:

curl -X POST https://api.wisderfin.ru/proxies/buy \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "ru",
    "period": 30,
    "count": 2,
    "version": "6",
    "proxy_type": "http"
  }'

Ответ

{
  "order_id": 9876,
  "price_charged": "59.80",
  "currency": "RUB",
  "proxies": [
    {
      "id": "11111",
      "host": "1.2.3.4",
      "port": "8080",
      "login": "u1",
      "password": "p1",
      "proxy_type": "http",
      "country": "ru",
      "version": "6",
      "date_start": "2025-01-01T00:00:00Z",
      "date_end": "2025-02-01T00:00:00Z",
      "active": true,
      "descr": null
    }
  ]
}

Поле	Тип	Описание
`order_id`	integer \| null	ID заказа
`price_charged`	string	Списанная сумма (Decimal, RUB)
`currency`	string	Валюта (`"RUB"`)
`proxies`	array	Массив купленных прокси

Ошибки

Код	detail	Причина
`400`	`Insufficient balance`	Недостаточно средств на балансе
`400`	`Minimum rental period for IPv6 is 3 days`	Период меньше минимального
`400`	`Unsupported proxy type`	Неверный proxy_type
`503`	`Service temporarily unavailable...`	Провайдер временно недоступен

Рекомендация

Перед покупкой проверьте стоимость через GET /price и наличие через GET /countries/{cc}/count.