Proxy-API-Dokumentation und Verbindungsmethoden
Hier finden Sie Anleitungen, wie Sie IPKite Residential Proxys mit Code und Tools verbinden, sowie die Entwickler-API zum Abfragen von Guthaben, Kaufhistorie und Proxy-Listen, begleitet von Beispielen.
Residential-Proxy Schnellstart
Beim Kauf eines Residential Proxys werden Benutzername und Passwort in Ihrem Konto angezeigt. Es gibt eine Verbindungsadresse, und Sie können Land, Stadt und Sitzung über Werte im Benutzernamen festlegen. Mit diesem Befehl können Sie die Verbindung sofort testen.
- Kauf: Wählen Sie auf der Benutzerseite die gewünschte GB-Menge für den Kauf von Residential Proxies.
- Prüfen: Im Benutzerbereich finden Sie den Proxy-Benutzernamen (USERNAME) und das Passwort (PASSWORD).
- Verbindung: Senden Sie Anfragen an die Adresse gw.ipkite.com über HTTP-Port 7000 oder SOCKS5-Port 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Proxy-Verbindungsdatenformat
Alle Residential-Proxys nutzen dieselbe Adresse. HTTP/HTTPS über Port 7000, SOCKS5 über Port 7100. Parameter mit Bindestrich an Username anhängen, nur benötigte Parameter verwenden.
| Artikel | Preis | Beschreibung |
|---|---|---|
| Adresse | gw.ipkite.com | Verbindungsdaten für alle Residential-Proxys |
| HTTP/HTTPS-Port | 7000 | Mit HTTP-Proxy mit HTTP- und HTTPS-Sites verbinden |
| SOCKS5-Port | 7100 | Verbindung in Tools und Apps, die SOCKS5 unterstützen |
| cc | Zweibuchstabiger Ländercode (Kleinbuchstaben) | Beispiel: cc-us, cc-gb, cc-de |
| city | Stadtname (Kleinbuchstaben, ohne Leerzeichen) | Beispiel: city-newyork, city-london |
| sess | Alphanumerischer Sitzungsname | Beibehalten derselben IP während der Verwendung desselben Werts |
| ttl | 1 bis 1,440 (Minuten) | Zeit, die die feste Sitzung aufrechterhalten wird |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Beispiele für rotierende Proxies und feste Sitzungen
Wenn Sie keinen sess-Wert an den Benutzernamen anhängen, wird ein rotierender Proxy verwendet, der bei jeder Anfrage eine neue IP zuweist. Wenn Sie sess und ttl anhängen, bleibt dieselbe IP für die angegebene Zeit (1-1.440 Minuten) erhalten. Wenn Sie eine neue IP benötigen, ändern Sie einfach den sess-Wert.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Beispiel für Land- und Stadt-Targeting
Mit dem cc-Parameter können Sie aus 174 Ländern/Regionen wählen, und mit dem city-Parameter können Sie die Suche auf bestimmte Städte eingrenzen. Länder- und Stadt-Targeting kann sowohl bei rotierenden als auch bei festen Sitzungen verwendet werden.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Python requests-Proxy-Beispiel
In Python requests geben Sie dieselbe Proxy-Adresse für HTTP und HTTPS ein. Für SOCKS5 installieren Sie requests[socks] und ändern die Adresse zu socks5h://.
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)Node.js-Proxy-Beispiel
In Node.js können Sie entweder den ProxyAgent von undici oder das https-proxy-agent-Paket verwenden. Beide benötigen nur eine Proxy-Adresse.
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);Entwickler-API-Authentifizierung und Basisadresse
Die Entwickler-API verwendet REST und alle Antworten sind im JSON-Format. Wenn Sie einen API-Schlüssel im Kontobereich generieren, wird der Schlüssel, der mit ipk_live_ beginnt, nur einmal angezeigt. Speichern Sie ihn sofort an einem sicheren Ort. Fügen Sie in allen Anfragen den Bearer und den API-Schlüssel in den Authorization-Header ein.
- Basis-URL: https://ipkite.com/api/v1
- Authentifizierungsheader: Authorization: Bearer <API-Schlüssel>
- Aufruflimit: 120 pro Minute
- Antwortformat: JSON, bei Erfolg "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Entwickler-API-Endpunkt
| Methode | Pfad | Inhalt | Wichtige Antwortwerte |
|---|---|---|---|
| GET | /balance | Aktuelles Guthaben | balance, currency |
| GET | /orders | Kaufübersicht | code, product, summary, amount, status, created_at |
| GET | /proxies | Gekaufte Proxy-Liste | Residential: username, password, host, http_port, socks_port, traffic_gb_left / Feste IP: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}API-Fehlerantworten und Aufruflimits
Wenn der API-Schlüssel fehlt oder nicht übereinstimmt, erhalten Sie eine HTTP-401-Antwort mit der folgenden Antwort. Überprüfen Sie den Header-Namen, das Leerzeichen nach Bearer und ob der gesamte Schlüssel enthalten ist. Das Aufruflimit beträgt 120 Mal pro Minute. Wenn Sie regelmäßig den Kontostand oder das verbleibende Datenvolumen überprüfen, können Sie dies einmal pro Minute tun, um das Limit nicht zu überschreiten.
{"ok":false,"error":"unauthorized"}