Документація
Документація 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.