Документация
Документация по API и интеграции прокси
Подключите любой HTTP или SOCKS5 клиент с одним хостом и одним логином на сеть, выбирайте местоположения и сессии с ключами в имени пользователя и управляйте планами через REST API.
Хосты и порты
Каждая сеть имеет один хост. HTTP и HTTPS используют первый порт, SOCKS5 использует второй. Имя пользователя и пароль берутся из плана в вашей панели управления и одинаковы для обоих протоколов.
| Сеть | Хост | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Резидентные прокси | res.proxyhive.cc | 7000 | 7001 |
| Мобильные прокси | mob.proxyhive.cc | 7100 | 7101 |
| Статические ISP прокси | isp.proxyhive.cc | 8000 | 8001 |
| Датацентровые прокси | dc.proxyhive.cc | 7200 | 7201 |
Статические ISP планы перечисляют каждый адрес с его собственным портом вместо общего хоста: подключитесь к ip:port с именем пользователя и паролем плана.
Ключи имени пользователя
Ключи добавляются к вашему имени пользователя через дефисы и могут комбинироваться в любом порядке. Без ключей ротирующий план возвращает случайный адрес в любой стране.
| Ключ | Что это делает | Сети |
|---|---|---|
| country-us | Двухбуквенный код страны ISO. | Резидентские, мобильные, датацентр |
| state-texas | Штат США или регион первого уровня. | Резидентские |
| city-new_york | Город, строчными буквами, пробелы заменены на подчеркивания. | Резидентские, мобильные |
| carrier-tmobile | Мобильный оператор в нижнем регистре, без пробелов. | Мобильные |
| session-a1b2c3 | Сохраняет один IP для сессии, от 6 до 10 букв или цифр. | Резидентские, мобильные, датацентр |
| ttl-30 | Минуты, в течение которых сессия сохраняет свой IP, от 1 до 1,440. По умолчанию 10. | Резидентские, мобильные, датацентр |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Примеры кода
Замените USER и PASS на логин вашего плана. Примеры отправляют один запрос через шлюз и выводят ответ.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
REST API
Базовый адрес https://proxyhive.cc/api/v1. Ответы в формате JSON и всегда содержат ok. Публичные конечные точки не требуют ключа; конечные точки аккаунта требуют заголовка Authorization: Bearer с API ключом со страницы вашего аккаунта.
| Метод | Путь | Что это делает | Ключ |
|---|---|---|---|
| GET | /plans | Каждый план с id, продуктом, размером, ставкой и ценой. | Нет |
| GET | /locations | Страны с размерами пула, городами и операторами. | Нет |
| GET | /balance | Ваш баланс в USD. | Да |
| POST | /orders | Купить план: id плана и страна (или любая). | Да |
| GET | /orders | Ваши планы с логинами, оставшимся трафиком и сроком действия. | Да |
| GET | /orders/{id} | Один план по его коду. | Да |
curl -X POST https://proxyhive.cc/api/v1/orders \
-H "Authorization: Bearer phk_..." \
-H "Content-Type: application/json" \
-d '{"plan": "res-100", "country": "any"}'{
"ok": true,
"order": {
"id": "HO-7K2M9QXR4T",
"product": "resi",
"plan": "res-100",
"quantity": 100,
"unit": "GB",
"status": "active",
"gateway": { "host": "res.proxyhive.cc", "http_port": 7000, "socks5_port": 7001, "username": "...", "password": "..." }
}
}Ошибки и ограничения
Неудачные вызовы возвращают ok: false с кодом ошибки и сообщением: unauthorized (401), bad_plan или bad_country (400), funds (402, с суммой, которая еще нужна), network (503, ничего не было списано) и rate_limited (429). Каждый API ключ может отправлять 300 запросов в минуту.
Начните работу с ProxyHive
Создайте аккаунт за секунды, пополните баланс криптовалютой и скопируйте свой первый логин для прокси. Каждый план начинается от $30.