Documentazione
Documentazione API proxy e integrazione
Connetti qualsiasi client HTTP o SOCKS5 con un host e un login per rete, scegli le posizioni e le sessioni con le chiavi nel nome utente e gestisci i piani con l'API REST.
Host e porte
Ogni rete ha un host. HTTP e HTTPS condividono la prima porta, SOCKS5 utilizza la seconda. Il nome utente e la password provengono dal piano nel tuo dashboard e sono gli stessi per entrambi i protocolli.
| Rete | Host | HTTP(S) | SOCKS5 |
|---|---|---|---|
| Proxy residenziali | res.proxyhive.cc | 7000 | 7001 |
| Proxy mobili | mob.proxyhive.cc | 7100 | 7101 |
| Proxy ISP statici | isp.proxyhive.cc | 8000 | 8001 |
| Proxy datacenter | dc.proxyhive.cc | 7200 | 7201 |
I piani ISP statici elencano ogni indirizzo con la propria porta invece di un host condiviso: connetti a ip:porta con il nome utente e la password del piano.
Chiavi del nome utente
Le chiavi sono aggiunte al tuo nome utente con trattini e possono essere combinate in qualsiasi ordine. Senza chiavi, un piano rotante restituisce un indirizzo casuale in qualsiasi paese.
| Chiave | Cosa fa | Reti |
|---|---|---|
| country-us | Codice paese ISO di due lettere. | Residenziale, mobile, datacenter |
| state-texas | Uno stato degli USA o una regione di primo livello. | Residenziale |
| city-new_york | Una città, minuscolo, spazi come underscore. | Residenziale, mobile |
| carrier-tmobile | Un operatore mobile, minuscolo, senza spazi. | Mobile |
| session-a1b2c3 | Mantiene un IP per la sessione, da 6 a 10 lettere o cifre. | Residenziale, mobile, datacenter |
| ttl-30 | Minuti in cui una sessione mantiene il suo IP, da 1 a 1,440. Predefinito 10. | Residenziale, mobile, datacenter |
USER-country-de-city-berlin-session-k7p2x9-ttl-60:PASS@res.proxyhive.cc:7000
Esempi di codice
Sostituisci USER e PASS con il login del tuo piano. Gli esempi inviano una richiesta attraverso il gateway e stampano la risposta.
curl -x res.proxyhive.cc:7000 -U "USER-country-us:PASS" \ https://example.com
API REST
Indirizzo base https://proxyhive.cc/api/v1. Le risposte sono JSON e portano sempre ok. Gli endpoint pubblici non necessitano di chiave; gli endpoint dell'account necessitano dell'intestazione Authorization: Bearer con la chiave API dalla pagina del tuo account.
| Metodo | Percorso | Cosa fa | Chiave |
|---|---|---|---|
| GET | /plans | Ogni piano con id, prodotto, dimensione, tariffa e prezzo. | No |
| GET | /locations | Paesi con dimensioni del pool, città e operatori. | No |
| GET | /balance | Il tuo credito in USD. | Sì |
| POST | /orders | Acquista un piano: id del piano e paese (o qualsiasi). | Sì |
| GET | /orders | I tuoi piani con login, traffico rimanente e scadenza. | Sì |
| GET | /orders/{id} | Un piano tramite il suo codice. | Sì |
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": "..." }
}
}Errori e limiti
Le chiamate fallite rispondono ok: false con un codice di errore e un messaggio: unauthorized (401), bad_plan o bad_country (400), funds (402, con l'importo ancora necessario), network (503, nulla è stato addebitato) e rate_limited (429). Ogni chiave API può inviare 300 richieste al minuto.
Inizia con ProxyHive
Crea un account in pochi secondi, aggiungi credito con crypto e copia il tuo primo login proxy. Ogni piano parte da $30.