Получение прокси

Получение прокси

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

Эндпоинт

GET /v1/proxy

Параметры

Параметр	Тип	Обязательный	Описание
target	string	Да	Целевой домен (например, amazon.com)
session_lock	boolean	Нет	Сохранять один и тот же IP в течение сессии (по умолчанию: false)
country	string	Нет	Код страны ISO 3166-1 alpha-2
ip_type	string	Нет	residential, datacenter или dedicated
session_ttl	integer	Нет	Таймаут сессии в секундах (по умолчанию: 1800)
auto_heal	boolean	Нет	Включить автоматическое переключение (по умолчанию: true)

Запрос

curl "https://api.hydraskill.ai/v1/proxy?target=amazon.com&session_lock=true&country=US" \
  -H "Authorization: Bearer sk-your-key"

Ответ

{
  "proxy_id": "px_abc123",
  "host": "us-res-42.proxy.hydraskill.ai",
  "port": 8080,
  "username": "session_abc123",
  "password": "px_token_xyz",
  "ip": "203.0.113.42",
  "country": "US",
  "type": "residential",
  "session_lock": true,
  "expires_at": "2026-05-30T16:30:00Z",
  "protocol": "http"
}

Использование с HTTP-клиентом

proxy = client.get_proxy(target="amazon.com", session_lock=True)

# Преобразуем в словарь, совместимый с requests
proxies = proxy.to_dict()
# {'http': 'http://user:pass@host:port', 'https': 'http://user:pass@host:port'}

response = requests.get(url, proxies=proxies)

Коды ошибок

Код	Значение
400	Отсутствует обязательный параметр target
401	Неверный API key
402	Недостаточный баланс / достигнут лимит тарифа
429	Превышен лимит запросов
503	Нет доступных прокси по заданным критериям