Магазин прокси

Просмотр и покупка доступных прокси.

Просмотр доступных прокси

Получите пагинированный список прокси, доступных для заказа, с опциональными фильтрами.

Endpoint

GET /proxies/shop/

Параметры запроса

Параметр	Тип	Обязательно	Описание
access_type	string	Нет	Тип доступа к прокси. Значения: shared, private
country	string	Нет	Фильтр по коду страны (ISO 3166-1 alpha-2, например, us, au)
proxy_category	string	Нет	Фильтр по категории. Значения: datacenter, lte, residential_rotating, residential_static
stock_status	string	Нет	Фильтр по наличию. Значения: in_stock, out_of_stock
page	integer	Нет	Номер страницы для пагинации
page_size	integer	Нет	Количество результатов на странице

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=lte' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "proxy_products": [
        {
          "id": "9a440c2a-157f-4562-8209-25022ec41430",
          "title": "Лучший прокси 1",
          "location_country_code": "us",
          "price_usd": "2.00",
          "days": 1,
          "proxy_category": "lte",
          "stock_status": "in_stock",
          "traffic_limitation": -1,
          "is_auto_renewal_possible": true
        }
      ],
      "title": "Лучший прокси",
      "proxy_category": "lte",
      "access_type": "private",
      "location_country_code": "us"
    }
  ]
}

Поля ответа

Поле	Тип	Описание
count	integer	Общее количество результатов
next	string	URL следующей страницы (null если последняя)
previous	string	URL предыдущей страницы (null если первая)
results	array	Массив групп прокси-продуктов
results[].title	string	Название группы
results[].proxy_category	string	Категория: datacenter, lte, residential_rotating, residential_static
results[].access_type	string	Тип доступа: shared или private
results[].location_country_code	string	Код страны
results[].proxy_products	array	Продукты в группе
proxy_products[].id	string (UUID)	Идентификатор продукта
proxy_products[].title	string	Название продукта
proxy_products[].location_country_code	string	Код страны
proxy_products[].price_usd	string	Цена в USD
proxy_products[].days	integer	Длительность в днях
proxy_products[].proxy_category	string	Категория
proxy_products[].stock_status	string	Наличие: in_stock или out_of_stock
proxy_products[].traffic_limitation	integer	Ограничение трафика в байтах (-1 для безлимитного)
proxy_products[].is_auto_renewal_possible	boolean	Доступно ли автопродление

Покупка прокси

Заказать один или несколько прокси.

Endpoint

POST /proxies/shop/buy_proxies/

Параметры запроса

Параметр	Тип	Обязательно	Описание
page	integer	Нет	Номер страницы для пагинации
page_size	integer	Нет	Количество результатов на странице

Запрос

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/buy_proxies/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ' \
  -H 'Content-Type: application/json' \
  -d '[
    {
      "id": "9a440c2a-157f-4562-8209-25022ec41430",
      "auto_renew": true
    },
    {
      "id": "24f80c50-5eb3-40fd-a785-eaf9456a045d",
      "auto_renew": false,
      "promo_code": "промокод_действителен"
    }
  ]'

Поля запроса

Поле	Тип	Обязательно	Описание
id	string (UUID)	Да	ID продукта из списка магазина
auto_renew	boolean	Да	Включить автопродление
promo_code	string	Нет	Опциональный промокод

Ответ

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "9a440c2a-157f-4562-8209-25022ec41430",
      "auto_renew": true,
      "status": "in_progress",
      "message": "9a440c2a-157f-4562-8209-25022ec4143a",
      "promo_code": null
    },
    {
      "id": "24f80c50-5eb3-40fd-a785-eaf9456a045d",
      "auto_renew": false,
      "status": "canceled",
      "message": "Промокод больше не применим. Пожалуйста, введите его заново.",
      "promo_code": "промокод_действителен"
    }
  ]
}

Статусы ответа

Статус	Описание
in_progress	Заказ обрабатывается
canceled	Заказ отклонен (см. сообщение для деталей)

Частые сообщения об ошибках

• "Not enough money." - Недостаточно средств
• "Promo code is not applicable anymore. Please re-enter it." - Промокод недействителен или истек