Справочник API

Документация

Всё необходимое для интеграции ProxyHat в ваши приложения

Быстрый старт

Начните работу за несколько минут

curl -x http://USERNAME:PASSWORD@proxy.proxyhat.com:8080 \
     https://api.example.com/data

Аутентификация

Защитите свои API-запросы с помощью учётных данных

Аутентификация по API-ключу

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

http://USERNAME:PASSWORD@proxy.proxyhat.com:PORT

Прокси-эндпоинты

Доступные шлюзы прокси-сервера

Резидентные
HTTP/HTTPS
residential.proxyhat.com
Порты:8080, 8443

Премиальные резидентные IP с AI-фильтрацией качества маршрутизации

Серверные
HTTP/HTTPS
dc.proxyhat.com
Порты:8080, 8443

Высокоскоростные серверные прокси для массовых операций

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

Настройте прокси-запросы с помощью этих параметров

ПараметрТипОписаниеПример
countrystringКод страны назначения (ISO 3166-1)country=US
citystringНазвание города назначенияcity=NewYork
sessionstringИдентификатор привязанной сессииsession=abc123
ttlnumberВремя жизни сессии в секундахttl=600

Примеры кода

Примеры реализации на популярных языках

Python
import requests

proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy, "https": proxy}
)
Node.js
const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');

const agent = new HttpsProxyAgent(
  'http://user:pass@residential.proxyhat.com:8080'
);
fetch('https://httpbin.org/ip', { agent });
Go
proxyURL, _ := url.Parse(
  "http://user:pass@residential.proxyhat.com:8080",
)
client := &http.Client{
  Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")

Заголовки ответа

Метаданные, возвращаемые с каждым проксированным запросом

X-ProxyHat-IP

Прокси-IP, использованный для этого запроса

Пример:203.0.113.45
X-ProxyHat-Country

Страна прокси-IP

Пример:US
X-ProxyHat-Latency

Задержка запроса в миллисекундах

Пример:48

Коды ошибок

Распространённые ошибки и способы их обработки

КодСтатусОписаниеРешение
407Требуется авторизацияНедействительные или отсутствующие учётные данныеПроверьте имя пользователя и пароль
429Превышен лимитСлишком много запросовУменьшите частоту запросов или обновите план
503НедоступенНет доступных прокси для заданных критериевПопробуйте другую страну или подождите

Лимиты запросов

Ограничения использования в зависимости от плана

Стартовый
100
запросов/минуту
10 GB пропускная способность
Профессиональный
500
запросов/минуту
100 GB пропускная способность
Корпоративный
Безлимитный
запросов/минуту
Безлимитный пропускная способность

Нужны более высокие лимиты?

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

Готовы начать?

Создайте аккаунт и начните использовать нашу прокси-инфраструктуру за считанные минуты.