Proxy residenziale
Updated:
Gestire a livello di programmazione pacchetti, elenchi e sessioni di proxy residenziali.
Un pacchetto è il tuo abbonamento residenziale: ha un limite di traffico e una data di scadenza. All’interno di un pacchetto puoi creare liste: insiemi denominati di indirizzi IP filtrati in base a criteri geografici (GEO) e regole di rotazione. Ti connetti al proxy utilizzando le credenziali (nome utente/password) della lista, e un singolo pacchetto può contenere molte liste per diversi casi d’uso.
Elenchi
creare, configurare e rimuovere elenchi di proxy
Leggi
Scrivere
Pacchetto
Altri controlli
Comune a tutti gli endpoint residenziali
URL di base
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/Autenticazione
Chiave API nel percorso dell’URL: non registrare mai gli URL completi delle richieste.
Modello di errore
Gli errori di business restituiscono un codice HTTP 200 con il campo errors[] popolato.
Dopo aver configurato i proxy
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpenDomande frequenti
Pacchetto — il tuo abbonamento (limite di traffico + scadenza). Elenco — un pacchetto contenente nome utente e password con filtri geografici e di whitelist, incluso all’interno di un pacchetto. Sessione — associazione temporanea di un indirizzo IP di uscita specifico a una singola connessione, creata al volo tramite _s_… suffisso al momento dell’accesso.
A livello di pacchetto. Un elenco è costituito semplicemente da credenziali e da un filtro; consumption-cost aggregati per login (cioè per elenco), ma gli addebiti effettivi gravano sul pool del pacchetto.
Ogni porta fornisce un IP di uscita indipendente: utilizzarle in parallelo per le richieste simultanee. Una porta = un IP di uscita in un dato momento.
Un elenco all’interno del pacchetto principale fornisce un bundle di credenziali/filtri, ma il suo traffico condivide il pool del pacchetto senza alcun limite. Un sottopacchetto si riserva una porzione fissa di traffico (traffic_limit) con una propria scadenza e un proprio interruttore di attivazione/disattivazione, restituendo il traffico inutilizzato al pacchetto padre al momento della cancellazione. Gli elenchi creati al suo interno funzionano allo stesso modo: vengono semplicemente addebitati sulla quota del sottopacchetto.
Utilizza un sottopacchetto quando hai bisogno di un limite rigido al traffico per qualcuno (un client, un team, una campagna), senza dover rinunciare alla tua chiave API. Tutta la gestione continua a avvenire tramite la tua chiave. Utilizza un semplice elenco quando hai bisogno solo di isolamento delle credenziali o geografico all’interno della tua quota.
Sì: https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... Le varianti dei sottoutenti utilizzano /residentsubuser/....
HTTP e SOCKS5 sullo stesso indirizzo IP.
Il rinnovo automatico di un pacchetto residenziale non è supportato dall’API pubblica. /extend-proxies (/prolong/calc/{type}, /prolong/make/{type}) accetta solo tipi basati su IP — ipv4, ipv6, mobile, isp, mix, mix_isp. resident non è presente in quell’elenco e non esiste /resident/prolong endpoint.
Rinnova il pacchetto residenziale tramite la dashboard prima che expired_at segnalato da get-package-information. Il comportamento esatto al momento della scadenza (connessioni attive, riporto del traffico inutilizzato) non è documentato nelle specifiche dell’API: verificare con l’assistenza se questo aspetto è rilevante per la propria integrazione.