Генерация списков HTTP- и SOCKS5-прокси через API

Используйте API прокси, когда программе или скрипту нужен повторяемый способ генерации списков подключений. Начните с небольшого запроса и подтвердите результат перед включением в большой процесс.

Генерация через API и браузер использует один и тот же сервис аккаунта. Раздельно выбирайте баланс трафика, размер списка, протокол и поведение сессии.

Подготовьте аккаунт и запрос

Создайте API-ключ в панели прокси и храните его в закрытом доступе. Bearer-ключ аутентифицирует запрос к API; сгенерированные данные прокси — последующие подключения через прокси.

Выберите от 1 до 1 000 строк, протокол, режим сессии и поддерживаемый формат выгрузки. Добавляйте необязательные поля местоположения только при намерении запросить эту локацию.

Страна задаётся двухбуквенным кодом. Регион требует страны, город — региона. Используйте идентификаторы из каталога локаций, а не придумывайте названия регионов или городов.

Запрос sticky может включать длительность от 1 до 120 минут. Запрос rotating не должен содержать это поле. Оценивайте поведение сессии отдельно от текстового формата.

Запросите небольшой список

Пример использует ключ-заглушку и запрашивает десять конфигураций SOCKS5 обычным текстом:

curl https://krantz.run/api/v1/proxies/generate   -H 'Authorization: Bearer YOUR_API_KEY'   -H 'Content-Type: application/json'   -H 'Accept: text/plain'   -d '{"count":10,"protocol":"socks5","session":"rotating","format":"host_port_user_pass"}'

В примере нет рабочего ключа или прокси. Запускайте его только со своим аккаунтом и настройками. Не включайте настоящие ключи или сгенерированные данные в публичные журналы и обращения в поддержку.

При точном заголовке Accept: text/plain генерация возвращает один прокси на строку. Без этого заголовка ответ имеет формат JSON и включает массив proxies.

Проверьте статус HTTP перед передачей тела другой программе. Ответ с ошибкой не становится списком прокси, пригодным для импорта, даже если скрипт сохранил его как текстовый файл.

Проверьте результат перед автоматизацией

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

Полученный пакет не обещает отдельный постоянный выходной IP для каждой конфигурации. Доступность sticky остаётся временной, а доступность локаций может меняться.

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

Если потребуется позже найти сохранённый пакет, запишите идентификатор генерации в заметки об операции. Защищайте выходные файлы: они содержат данные аутентификации прокси.

Документация настройки перечисляет поддерживаемые маршруты и все пять форматов выгрузки. Статьи о протоколах и стоимости объясняют решения, которые сама генерация за вас не принимает.