Як автоматизувати закупівлю адрес: гайд з API магазину проксі та масштабування інфраструктури

Масштабування збору даних працює стабільно рівно до моменту вигорання пулу адрес посеред ночі. Ваш парсер видає стіну помилок. Робота пайплайнів повністю зупиняється. Комусь потрібно прокинутися, зайти в панель управління і наклікати оренду нових проксі. Ручне управління інфраструктурою ламається при великих масштабах.

Вам потрібен код для вирішення цього завдання. Вам необхідно вивчити налаштування API магазину проксі.

Tl;DR: автоматизована купівля проксі

• Масштабуйте мережеву інфраструктуру миттєво без входу у веб-інтерфейс.

• API магазину дозволяє скриптам купувати і продовжувати проксі автоматично.

• Відправляйте масиви JSON безпосередньо з вашого серверного коду.

• Підготуйте автономних ІІ-агентів до платіжного протоколу x402.

Вузьке місце ручної закупівлі проксі

Управління тисячами запитів вимагає безперервного потоку трастових IP-адрес. Ручна закупівля десятків серверних, мобільних або резидентських проксі спалює години робочого часу. Це породжує випадкові системні помилки. Це також робить неможливим миттєве реагування на мережеві фільтри цільових сайтів.

Коли адреса відвалюється, весь процес чекає на людину. Але програмний код не спить.

👉 Купити виділені мобільні LTE/5G проксі

Інфраструктура як код через API магазину проксі

Ставтеся до мережевого рівня як до програмованих ресурсів. Використання API магазину проксі перетворює CyberYozh на платформу інфраструктури як коду (IaaC). Розробники вбудовують REST API для провіжинінгу прямо в CI/CD пайплайни, скрипти Node.js або автоматизацію на Python.

Виконуючи масштабування інфраструктури через REST-запити, ваш код докуповує гігабайти резидентського трафіку або орендує нові приватні 4G/5G-порти рівно в той момент, коли цільовий сайт блокує поточний IP. Це і є повна автоматизація оренди проксі. 

👉 Обрати статичні резидентські IP

Технічне налаштування та основні ендпоінти

Купівля проксі через REST API вимагає захищеного з'єднання. Згенеруйте ключ у панелі управління CyberYozh.

Авторизація запитів до магазину проксі за Bearer-токеном — це галузевий стандарт, що виключає передачу облікових даних у відкритому вигляді та гарантує безпеку інфраструктури. Передавайте цей ключ у заголовках кожного виклику (будь то POST-запит чи GET) для безпечного доступу до ендпоінтів білінгу.

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=datacenter' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Система обробляє запити через конкретні точки доступу:

• /v2/users/balance/ (GET). Перевіряє доступний баланс акаунта перед ініціалізацією замовлення для уникнення помилок нестачі коштів.

• /proxies/shop/ (GET). Запитує динамічний список доступних локацій і категорій.

• /proxies/shop/buy_proxies/ (POST). Приймає JSON для негайної оренди мережевої інфраструктури.

👉 Орендувати швидкі серверні проксі

Як автоматизувати купівлю проксі через API та вказувати правильні параметри

Програмне виділення ресурсів проксі відбувається через відправку масиву позицій на сервер. Формування замовлення проксі через JSON дозволяє налаштувати кожен порт незалежно.

Змінна id всередині структури JSON payload містить точний UUID продукту. Ви отримуєте цей ідентифікатор після попереднього GET-запиту до ендпоінту /proxies/shop/.

Щоб не завантажувати весь каталог, одразу фільтруйте видачу. Вкажіть локацію через параметр country та обмежте тип мережі за допомогою proxy_category (варіанти: datacenter, lte, residential_rotating, residential_static). Оберіть рівень приватності через access_type (shared або private). Залишіть тільки доступні для купівлі порти, передавши stock_status=in_stock.

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/shop/?country=us&proxy_category=datacenter&access_type=private&stock_status=in_stock' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: your_api_key_here'

Скопіювавши потрібний id з відповіді сервера, ви задаєте кількість портів через quantity, а period_months фіксує термін оренди.

Ви також можете застосувати promo_code для зниження підсумкової ціни.

Логічний прапорець auto_renew активує API автоматичного продовження проксі.

Ви отримуєте повноцінний API управління підписками на проксі, повністю позбуваючись ручного контролю термінів оренди. Детальний опис усіх підтримуваних змінних і форматів відповідей сервера знаходиться в технічному довіднику.

👉 Вивчити документацію Proxy Shop API

[
  {
    "id": "f3e3ec3b-e6eb-40a7-b2d2-9125acb3093c",
    "auto_renew": false,
    "quantity": 2,
    "period_months": 3
  }
]

Сервер миттєво розраховує підсумкову ціну. Він списує кошти з балансу. Якщо грошей не вистачає, замовлення одразу отримує статус скасування.

👉 Ознайомтеся з каталогом проксі CyberYozh App

Моніторинг репутації IP та автоматична заміна проксі через API

Уявіть масштабну роботу з ізольованими профілями. Скрипт періодично перевіряє Fraud Score поточної статичної адреси через внутрішній чекер. При пікових навантаженнях сервер може повернути статус 429 Too Many Requests. Ваш код повинен обробити цей ліміт через експоненційну затримку (exponential backoff) і повторити запит пізніше. Як тільки IP потрапляє в чорний список, обробник помилок відбраковує його і миттєво викликає API магазину для покупки чистої статичної адреси.

import requests

# 1. Проверяем текущий статический IP на Fraud Score

check_response = requests.post(
    'https://app.cyberyozh.com/api/v1/checkers/socks/',
    headers={'X-Api-Key': 'your_api_key'},
    json={"ips": ["198.51.100.14"]}
)

# 2. Если адрес скомпрометирован, скрипт покупает новый статический IP на замену

order_response = requests.post(
    'https://app.cyberyozh.com/api/v1/proxies/shop/buy_proxies/',
    headers={'X-Api-Key': 'your_api_key'},
    json=[{
        "id": "f3e3ec3b-e6eb-40a7-b2d2-9125acb3093c",
        "quantity": 1,
        "period_months": 1
    }]
)

Сервер видає нові реквізити за секунди. Парсер відновлює роботу без участі людини.

👉 Підключити резидентські ротаційні проксі

Автономні агенти та протокол x402

Стандартний білінг створює серйозну перешкоду для автономних ІІ-агентів. Вони генерують непередбачуваний обсяг трафіку. Програмний код не може вводити дані банківських карт у платіжні шлюзи або підтверджувати транзакції по SMS при класичному поповненні балансу.

Інтеграція API магазину проксі для автономних ботів готує ваш стек до ери машинної комерції. Коли скрипт або агент звертається до ендпоінтів покупки без попередньо поповненого балансу, сервер повертає статус HTTP 402 Payment Required. 

Правильна обробка помилки 402 Payment Required запускає механізм агентських платежів (agentic payments). Агент зчитує вартість із заголовка, підписує транзакцію і надсилає криптографічне доказ назад. Сервер верифікує оплату проксі за протоколом x402 і миттєво видає робочі облікові дані (хост, порт, пароль) для нового проксі-сервера. Програмний провіжинінг інфраструктури прибирає рутинну тяганину з корпоративними картками.

Часті питання про API магазину проксі

Скільки ресурсів можна купити одним запитом?

Ви можете замовити до 50 позицій за один виклик. Це зберігає високу швидкість відповіді сервера.

Як API магазину проксі обробляє нестачу коштів?

Система повертає статус скасування з кодом insufficient_funds. Ваш код має перехопити цю помилку і запустити внутрішнє сповіщення про баланс.

Чи підтримує система автоматичне продовження?

Так. Ви просто встановлюєте логічне значення auto_renew у true всередині вашого JSON.

Що відбувається при збої одного елемента в масовому замовленні?

Ендпоінт обробляє кожну позицію масиву цілком незалежно. Валідні елементи успішно оплачуються.

Як фільтрувати доступні пули за країнами?

Додайте параметр country до вашого GET-запиту. Використовуйте стандартний формат ISO 3166-1 alpha-2.

Чи підтримує фільтр протоколи HTTP і SOCKS5?

Так. Передайте логічні параметри connection_port_http або connection_port_socks5 для звуження результатів пошуку.

Як обробляти довгі списки продуктів?

Використовуйте параметри пагінації page і page_size. Вони дозволяють розбивати великі відповіді сервера на короткі читабельні блоки.

Де знайти повний список методів роботи з проксі через API?

Вивчіть усі доступні ендпоінти, обмеження та параметри маршрутизації в офіційній документації CyberYozh API.