Руководство для разработчиков

Вы подключаетесь к шлюзу по логину и паролю. Всё остальное, например страна и сессия, задаётся в логине.

Параметры подключения

После покупки кабинет показывает хост, порты, логин и пароль каждого плана. В примерах ниже замените PROXY_HOST на хост из кабинета.

Протокол	Порт	Формат
HTTP (также туннель к HTTPS-сайтам)	8080	`http://USERNAME:PASSWORD@PROXY_HOST:8080`
SOCKS5	1080	`socks5://USERNAME:PASSWORD@PROXY_HOST:1080`

Некоторым инструментам нужен формат host:port:user:pass. Это те же четыре значения, а списки переведёт конвертер форматов.

Есть ли API для клиентов?

REST API для клиентов пока нет. Прокси работают по стандартным HTTP и SOCKS5, поэтому для их использования API не нужен. Планы, учётные данные и расход управляются в кабинете.

Примеры

Каждый пример обращается к нашему IP-эндпоинту через прокси и выводит выходной адрес.

cURL

export PROXY_USER="your-username"
export PROXY_PASS="your-password"

curl --proxy "http://PROXY_HOST:8080" \
  --proxy-user "$PROXY_USER:$PROXY_PASS" \
  "https://proxyron.com/api/tools/myip"

Python

import os
import requests  # pip install requests

user = os.environ["PROXY_USER"]
password = os.environ["PROXY_PASS"]
proxy = f"http://{user}:{password}@PROXY_HOST:8080"

response = requests.get(
    "https://proxyron.com/api/tools/myip",
    proxies={"http": proxy, "https": proxy},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Node.js

// npm install undici
import { ProxyAgent, fetch } from "undici";

const credentials = `${process.env.PROXY_USER}:${process.env.PROXY_PASS}`;
const dispatcher = new ProxyAgent({
  uri: "http://PROXY_HOST:8080",
  token: "Basic " + Buffer.from(credentials).toString("base64"),
});

const response = await fetch("https://proxyron.com/api/tools/myip", { dispatcher });
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Таргетинг через логин

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

Параметр	Пример
Страна	`USERNAME-country-US`
Несколько стран	`USERNAME-country-US,DE,FR`
Регион и город	`USERNAME-country-DE-state-DEBAY21-city-MUN1`
Провайдер	`USERNAME-country-DE-asn-3320`
Sticky-сессия	`USERNAME-country-US-session-ab12cd-time-10`

Указывайте локацию или провайдера, но не то и другое. Несколько стран нельзя совмещать ни с тем, ни с другим.
Коды городов внутри страны не уникальны, поэтому вместе с городом всегда передавайте регион.
Кабинет показывает коды регионов, городов и провайдеров по странам и сам собирает логин.

Ротация и сессии

Без сессии IP меняется при каждом запросе. С -session-ab12cd-time-10 один и тот же идентификатор из шести символов (строчные буквы и цифры) держит один IP 10 минут. Новый идентификатор даёт новый IP. Кабинет принимает длительность от 1 до 1440 минут.

Обработка ошибок

Относитесь к прокси как к любой сетевой зависимости: задавайте таймауты, повторяйте с паузой и учитывайте, что sticky IP может исчезнуть. Если после сброса пароля запросы падают с ошибкой авторизации, обновите сохранённый пароль: сброс действует сразу. Когда на плане кончился трафик или он на паузе, запросы не проходят, пока вы не пополните или не возобновите план.

Инструменты

Генератор кода создаёт примеры под ваш хост и добавляет Playwright, генератор URL собирает логины с таргетингом, а Мой IP показывает адрес, с которого вы пришли.