Integrazione · Errori e risoluzione dei problemi

Ogni stato a cui il gateway può rispondere e cosa modificare.

Gli errori del gateway vengono forniti con una breve motivazione nel corpo. Gli errori target passano intatti. Distinguere i due è la maggior parte della risoluzione dei problemi.

4 minuti di lettura 5 sezioni Aggiornato 26 settembre 2026

Risposte dal gateway#

Stato	La ragione nel corpo	Causa	Correggi
407 Autenticazione proxy richiesta	credenziali_non valide	Nome utente o password errati oppure l'IP di connessione non è nella whitelist e non sono state inviate credenziali	Copia nuovamente la coppia dalla dashboard; confronta la whitelist `curl https://api.ipify.org` eseguito senza proxy
400 Richiesta errata	parametro_non valido: …	Un parametro nome utente è sconosciuto o non ha un formato corretto oppure la combinazione non è valida (`-state-` fuori dagli Stati Uniti, `-city-` senza `-cc-`)	Correggi la stringa denominata nel corpo; vedere Targeting e sessioni
402 Pagamento richiesto	saldo_insufficiente	Nessun traffico rimasto sulla rete del pool in uso oppure il subutente ha raggiunto il limite	Acquista traffico o aumenta il limite di sottoutenti; controllare `GET /v1/balance`
403 Proibito	destinazione_bloccata	La destinazione o la porta non sono consentite (porta 25 o una destinazione nel nostro elenco rifiutati) oppure l'account è sospeso	Leggi il motivo; contattaci se ritieni che una destinazione sia elencata erroneamente
502 Gateway difettoso	no_uscita_disponibile / uscita_non riuscita	Nessun dispositivo online per i parametri oppure il dispositivo scelto è caduto a metà della richiesta	Riprova una volta (la rotazione seleziona già un'altra uscita); ampliare il targeting se si ripete
504 Timeout del gateway	target_timeout	Il bersaglio non ha risposto attraverso l'uscita entro il tempo limite	Riprovare con un nuovo IP; aumentare il timeout del client se l'obiettivo è lento per natura

Errore del gateway o errore del target?#

Un errore del gateway arriva prima di qualsiasi byte dal target: su una richiesta HTTPS è la risposta al file CONNECT, che la maggior parte dei client segnala come un errore di connessione o proxy anziché come risposta HTTP. Un errore di destinazione arriva all'interno del tunnel con le intestazioni e il corpo della destinazione. curl -v mostra immediatamente la differenza: guarda quale risposta segue CONNECT.

Lista di controllo diagnostica#

Esegui la richiesta più semplice: curl -x http://USER:PASS@res.proxy-cyber.com:9000 https://api.ipify.org senza parametri. Se funziona, il problema è in un parametro o nel client.
Controlla lo schema del proxy: l'URL del proxy inizia con http:// (o socks5h:// su 9001), mai https://, anche per destinazioni HTTPS.
Aggiungi i parametri uno alla volta. 400 nomina quello cattivo; 502 su una combinazione ristretta significa che nessuno è online in quel momento.
Utenti della whitelist: confronta l'indirizzo in Impostazioni → Lista bianca con l'output di curl https://api.ipify.org senza proxy, eseguito sulla stessa macchina. Le istanze cloud spesso escono attraverso un gateway NAT con un indirizzo diverso.
Controlla il saldo della rete che stai effettivamente utilizzando: il traffico residenziale e quello mobile sono saldi separati.
Cerca le variabili di ambiente (HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY) che sovrascrivono ciò che passi nel codice.
Se il certificato TLS non riesce a verificare, qualcosa tra te e il gateway intercetta TLS (proxy aziendale, antivirus). Il gateway non tocca mai i certificati.

Sintomi e loro causa abituale#

Vedi	Di solito significa	Fai questo
`curl: (56) Received HTTP code 407 from proxy after CONNECT`	Credenziali rifiutate	Ricopiarli; caratteri speciali con codifica percentuale se imposti la tua password
Lo stesso IP su ogni richiesta	Il tuo client riutilizza una connessione keep-alive oppure ne hai lasciata una `-sid-` nel nome utente	Chiudi le connessioni tra le richieste o elimina l'ID di sessione
Tuttavia, un IP diverso su ogni richiesta `-sid-` è impostato	La durata è inferiore all'intervallo tra le richieste o all'ID che cambia per richiesta (un valore casuale in un modello)	Correggi l'id, rilancia `-ttl-`
`Connection reset by peer` a metà download	La famiglia è andata offline	Riprova; con la rotazione utilizza già un'altra uscita; in una sessione permanente la richiesta successiva ottiene un nuovo IP
Funziona in curl, fallisce nel browser	Il browser non dispone di password proxy oppure il flag ignora le credenziali	Utilizza l'autenticazione del drammaturgo o del burattinaio oppure il file lista bianca
Il target risponde 403 o un CAPTCHA	Il target segna la visita, non il proxy	Passa al residenziale o al mobile, aggiungi una sessione fissa per flussi in più fasi, abbina le intestazioni al paese di uscita, ritmo per dominio
Tutto è lento	Uscita lontana o nucleo familiare su una linea debole	Scegli il Paese più vicino all'obiettivo, mantieni le sessioni brevi in modo che la successiva arrivi su una linea migliore oppure utilizza il data center o l'ISP per la massima velocità
`SSL certificate problem`	Intercettazione TLS dalla tua parte	Rimuovi l'intercettazione o fidati della sua radice; il gateway non è coinvolto

Ancora bloccato#

Inviaci la richiesta esatta (credenziali rimosse), il timestamp in UTC, lo stato e il corpo che hai ricevuto e l'IP di uscita se la richiesta è andata a buon fine. Il pagina dei contatti spiega come raggiungere la squadra; i titolari di un conto aprono un ticket dalla dashboard.

Proxy

Menù