Dokumentation
Proxy-API und Integrationsdokumentation
Verbinden Sie jeden HTTP- oder SOCKS5-Client mit einem Host und einer Anmeldung pro Netzwerk, wählen Sie Standorte und Sitzungen mit Schlüsseln im Benutzernamen und verwalten Sie Pläne mit der REST-API.
Hosts und Ports
Jedes Netzwerk hat einen Host. HTTP und HTTPS teilen sich den ersten Port, SOCKS5 verwendet den zweiten. Benutzername und Passwort stammen aus dem Plan in Ihrem Dashboard und sind für beide Protokolle gleich.
| Netzwerk | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Residential-Proxys | res.proxyhive.cc | 7000 | 7001 |
| Mobile-Proxys | mob.proxyhive.cc | 7100 | 7101 |
| Statische ISP-Proxys | isp.proxyhive.cc | 8000 | 8001 |
| Datacenter-Proxys | dc.proxyhive.cc | 7200 | 7201 |
Statische ISP-Pläne listen jede Adresse mit ihrem eigenen Port anstelle eines gemeinsamen Hosts auf: Verbinden Sie sich mit ip:port mit dem Benutzernamen und Passwort des Plans.
Benutzernamen-Schlüssel
Schlüssel werden mit Bindestrichen an Ihren Benutzernamen angehängt und können in beliebiger Reihenfolge kombiniert werden. Ohne Schlüssel liefert ein rotierender Plan eine zufällige Adresse in einem beliebigen Land.
| Schlüssel | Funktion | Netzwerke |
|---|---|---|
| country-us | Zweibuchstabiger ISO-Ländercode. | Residential, Mobile, Datacenter |
| state-texas | Ein US-Bundesstaat oder eine Region der ersten Ebene. | Residential |
| city-new_york | Eine Stadt, klein geschrieben, Leerzeichen als Unterstriche. | Residential, Mobile |
| carrier-tmobile | Ein Mobilfunkanbieter in Kleinbuchstaben, ohne Leerzeichen. | Mobile |
| session-a1b2c3 | Behält eine IP für die Sitzung, 6 bis 10 Buchstaben oder Ziffern. | Residential, Mobile, Datacenter |
| ttl-30 | Minuten, die eine Sitzung ihre IP behält, 1 bis 1.440. Standard 10. | Residential, Mobile, Datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Code-Beispiele
Ersetzen Sie USER und PASS durch die Anmeldedaten Ihres Plans. Die Beispiele senden eine Anfrage über das Gateway und geben die Antwort aus.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
REST-API
Basisadresse https://proxyhive.cc/api/v1. Antworten sind JSON und enthalten immer ok. Öffentliche Endpunkte benötigen keinen Schlüssel; Kontendpunkte benötigen den Header Authorization: Bearer mit dem API-Schlüssel von Ihrer Kontoseite.
| Methode | Pfad | Funktion | Schlüssel |
|---|---|---|---|
| GET | /plans | Jeder Plan mit ID, Produkt, Größe, Preis und Rate. | Nein |
| GET | /locations | Länder mit Pool-Größen, Städten und Anbietern. | Nein |
| GET | /balance | Ihr Guthaben in USD. | Ja |
| POST | /orders | Kaufen Sie einen Plan: Plan-ID und Land (oder beliebig). | Ja |
| GET | /orders | Ihre Pläne mit Anmeldedaten, verbleibendem Datenvolumen und Ablaufdatum. | Ja |
| GET | /orders/{id} | Ein Plan anhand seines Codes. | Ja |
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": "..." }
}
}Fehler und Limits
Fehlgeschlagene Aufrufe antworten mit ok: false und einem Fehlercode sowie einer Nachricht: unauthorized (401), bad_plan oder bad_country (400), funds (402, mit dem noch benötigten Betrag), network (503, nichts wurde belastet) und rate_limited (429). Jeder API-Schlüssel darf 300 Anfragen pro Minute senden.
Steigen Sie mit ProxyHive ein
Erstellen Sie in Sekunden ein Konto, fügen Sie Guthaben mit Krypto hinzu und kopieren Sie Ihren ersten Proxy-Login. Jeder Plan beginnt bei $30.