Dokumentacja
Dokumentacja API proxy i integracji
Podłącz dowolnego klienta HTTP lub SOCKS5 z jednym hostem i jednym loginem na sieć, wybieraj lokalizacje i sesje za pomocą kluczy w nazwie użytkownika oraz zarządzaj planami za pomocą REST API.
Hosty i porty
Każda sieć ma jeden host. HTTP i HTTPS współdzielą pierwszy port, SOCKS5 używa drugiego. Nazwa użytkownika i hasło pochodzą z planu w Twoim panelu i są takie same dla obu protokołów.
| Sieć | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proxy rezydencyjne | res.proxyhive.cc | 7000 | 7001 |
| Proxy mobilne | mob.proxyhive.cc | 7100 | 7101 |
| Statyczne proxy ISP | isp.proxyhive.cc | 8000 | 8001 |
| Proxy datacenter | dc.proxyhive.cc | 7200 | 7201 |
Plany statycznych ISP zawierają listę każdego adresu z własnym portem zamiast współdzielonego hosta: połącz się z ip:port używając nazwy użytkownika i hasła z planu.
Klucze nazwy użytkownika
Klucze są dołączane do nazwy użytkownika z łącznikami i można je łączyć w dowolnej kolejności. Bez kluczy rotujący plan zwraca losowy adres w dowolnym kraju.
| Klucz | Funkcja | Sieci |
|---|---|---|
| country-us | Dwuliterowy kod kraju ISO. | Rezydencjalne, mobilne, datacenter |
| state-texas | Stan USA lub region pierwszego poziomu. | Rezydencjalne |
| city-new_york | Miasto, małe litery, spacje jako podkreślenia. | Rezydencjalne, mobilne |
| carrier-tmobile | Jeden operator komórkowy, małe litery, bez spacji. | Mobilne |
| session-a1b2c3 | Utrzymuje jeden IP dla sesji, 6 do 10 liter lub cyfr. | Rezydencjalne, mobilne, datacenter |
| ttl-30 | Minuty, przez które sesja utrzymuje swój IP, 1 do 1,440. Domyślnie 10. | Rezydencjalne, mobilne, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Przykłady kodu
Zastąp USER i PASS loginem z Twojego planu. Przykłady wysyłają jedno żądanie przez bramę i wyświetlają odpowiedź.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
REST API
Adres bazowy https://proxyhive.cc/api/v1. Odpowiedzi są w formacie JSON i zawsze zawierają ok. Publiczne endpointy nie wymagają klucza; endpointy konta wymagają nagłówka Authorization: Bearer z kluczem API z Twojej strony konta.
| Metoda | Ścieżka | Funkcja | Klucz |
|---|---|---|---|
| GET | /plans | Każdy plan z id, produktem, rozmiarem, stawką i ceną. | Nie |
| GET | /locations | Kraje z rozmiarami puli, miastami i operatorami. | Nie |
| GET | /balance | Twoje saldo w USD. | Tak |
| POST | /orders | Kup plan: id planu i kraj (lub dowolny). | Tak |
| GET | /orders | Twoje plany z loginami, pozostałym ruchem i datą wygaśnięcia. | Tak |
| GET | /orders/{id} | Jeden plan według jego kodu. | Tak |
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": "..." }
}
}Błędy i limity
Nieudane wywołania zwracają ok: false z kodem błędu i wiadomością: unauthorized (401), bad_plan lub bad_country (400), funds (402, z kwotą, której jeszcze brakuje), network (503, nic nie zostało obciążone) i rate_limited (429). Każdy klucz API może wysłać 300 żądań na minutę.
Rozpocznij z ProxyHive
Utwórz konto w kilka sekund, dodaj saldo kryptowalutami i skopiuj swoje pierwsze dane logowania proxy. Każdy plan zaczyna się od $30.