Documentazione API proxy e metodi di connessione

Guida rapida proxy residenziali

Quando acquisti un proxy residenziale, nella tua area personale troverai username e password del proxy. L'indirizzo di connessione è unico, e puoi specificare paese, città e sessione aggiungendo parametri all'username. Ecco un comando per testare subito la connessione.

• Acquisto: nella schermata del membro, seleziona i GB desiderati e acquista il proxy residenziale.
• Verifica: controlla il nome utente (USERNAME) e la password (PASSWORD) del proxy nella schermata del membro.
• Connessione: invia le richieste all'indirizzo gw.ipkite.com sulla porta HTTP 7000 o SOCKS5 7100.

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

Formato dettagli connessione proxy

Tutte le connessioni proxy residenziali utilizzano lo stesso indirizzo. Le richieste HTTP e HTTPS vengono inviate alla porta 7000, le connessioni SOCKS5 alla porta 7100. Aggiungi i parametri dopo il nome utente con un trattino (-) e usa solo i parametri desiderati.

USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

Esempi di proxy rotante e sessione fissa

Se non aggiungi un valore sess al nome utente, funziona come un proxy rotante che assegna un nuovo IP per ogni richiesta. Se aggiungi sess e ttl, diventa una sessione fissa che mantiene lo stesso IP per il tempo specificato da ttl (1-1,440 minuti). Puoi cambiare il valore sess quando hai bisogno di un nuovo IP.

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

Esempio di targeting per paese/città

Usa il parametro cc per scegliere tra 174 paesi/regioni, e city per specificare città principali. Il targeting geografico funziona sia con sessioni rotanti che fisse.

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

Esempio Python requests

In Python requests, inserisci lo stesso indirizzo proxy per HTTP e HTTPS in proxies. Per SOCKS5, installa requests[socks] e usa socks5h:// nell'URL.

import requests

proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)

Esempio proxy Node.js

In Node.js, usa ProxyAgent di undici o il pacchetto https-proxy-agent. Basta inserire una riga con l'indirizzo proxy.

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);

Autenticazione e indirizzo base dell'API per sviluppatori

L'API per sviluppatori è in stile REST e tutte le risposte sono in JSON. Quando generi una chiave API dall'account, viene visualizzata una chiave che inizia con ipk_live_ solo una volta, quindi salvala immediatamente in un luogo sicuro. Invia tutte le richieste con l'intestazione Authorization contenente Bearer e la chiave API.

• Indirizzo di base: https://ipkite.com/api/v1
• Intestazione di autenticazione: Authorization: Bearer <API key>
• Limite di chiamata: 120 volte al minuto
• Formato della risposta: JSON, in caso di successo "ok": true

curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

Endpoint API per sviluppatori

{"ok":true,"balance":"25.00","currency":"USD"}

Errori API e limiti di chiamata

Se la chiave API è mancante o non corretta, riceverai una risposta HTTP 401. Verifica il nome dell'header, lo spazio dopo 'Bearer' e che la chiave sia completa. Il limite è di 120 chiamate al minuto. Per controllare saldo o traffico residuo, una chiamata al minuto è sufficiente per rimanere entro i limiti.

{"ok":false,"error":"unauthorized"}