Documentation API des proxies et méthodes de connexion
Guide pour connecter les proxies résidentiels IPKite à vos outils et code, avec des exemples d'utilisation de l'API développeur pour consulter solde, historique d'achat et liste de proxies.
Démarrage rapide proxy résidentiel
Lorsque vous achetez un proxy résidentiel, votre nom d'utilisateur et mot de passe proxy s'affichent sur votre écran membre. Il y a une seule adresse de connexion, et vous spécifiez le pays, la ville et la session en ajoutant des valeurs au nom d'utilisateur. Vous pouvez vérifier la connexion immédiatement avec cette commande.
- Achat : Sur votre espace membre, sélectionnez les GB souhaités pour acheter des proxies résidentiels.
- Vérification : confirmez le nom d'utilisateur (USERNAME) et mot de passe (PASSWORD) du proxy dans votre espace membre.
- Connexion : envoyez les requêtes à l'adresse gw.ipkite.com sur les ports HTTP 7000 ou SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Format des informations de connexion proxy
Toutes les connexions de proxies résidentiels utilisent la même adresse. Les requêtes HTTP et HTTPS sont envoyées via le port 7000, les connexions SOCKS5 via le port 7100. Ajoutez des paramètres après le nom d'utilisateur avec un tiret (-), et utilisez uniquement les paramètres souhaités.
| Article | Prix | Description |
|---|---|---|
| Adresse | gw.ipkite.com | Adresse de connexion pour toutes les connexions de proxies résidentiels |
| Ports HTTP et HTTPS | 7000 | Se connecter aux sites HTTP et HTTPS via un proxy HTTP |
| Port SOCKS5 | 7100 | Connexion depuis outils/applis supportant SOCKS5 |
| cc | Code pays à deux lettres (minuscules) | Ex : cc-us, cc-gb, cc-de |
| city | Nom de la ville (minuscules, sans espaces) | Ex : city-newyork, city-london |
| sess | Nom de session alphanumérique | Maintenir la même IP en utilisant la même valeur |
| ttl | 1~1 440 (minutes) | Durée de maintien de la session fixe |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Exemples de proxy rotatif et session persistante
Si vous n'ajoutez pas de valeur sess au nom d'utilisateur, le proxy fonctionne en rotation avec une nouvelle IP à chaque requête. Si vous ajoutez sess et ttl, vous obtenez une session fixe avec la même IP pendant la durée spécifiée (1 à 1 440 minutes). Changez simplement la valeur sess lorsque vous avez besoin d'une nouvelle 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/Exemple de ciblage par pays et ville
Utilisez le paramètre cc pour choisir parmi 174 pays/régions, et city pour affiner par ville. Le ciblage fonctionne avec les sessions rotatives et fixes.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Exemple Python requests avec proxy
Avec Python requests, utilisez la même adresse proxy pour HTTP et HTTPS dans proxies. Pour SOCKS5, installez requests[socks] et utilisez 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)Exemple Node.js avec proxy
Dans Node.js, utilisez ProxyAgent (undici) ou https-proxy-agent. Une seule ligne d'adresse proxy suffit.
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);Authentification et adresse de base de l'API développeur
L'API développeur utilise le protocole REST et toutes les réponses sont en JSON. Lorsque vous générez une clé API dans l'interface du compte, une clé commençant par ipk_live_ est affichée une seule fois, veillez à la sauvegarder immédiatement dans un endroit sûr. Incluez Bearer et la clé API dans l'en-tête Authorization de chaque requête.
- URL de base : https://ipkite.com/api/v1
- En-tête d'authentification : Authorization: Bearer <clé API>
- Limite d'appels : 120 par minute
- Format de réponse : JSON, succès indiqué par "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Point de terminaison de l'API développeur
| Méthode | Chemin | Contenu | Valeurs de réponse principales |
|---|---|---|---|
| GET | /balance | Solde actuel | balance, currency |
| GET | /orders | Liste des détails des achats | code, product, summary, amount, status, created_at |
| GET | /proxies | Liste des proxies achetés | Résidentiel : username, password, host, http_port, socks_port, traffic_gb_left / IP fixe : ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Réponses d'erreur API et limites d'appel
Si la clé API est absente ou incorrecte, une réponse HTTP 401 sera renvoyée. Vérifiez le nom de l'en-tête, l'espace après Bearer et que la clé entière est incluse. La limite d'appel est de 120 fois par minute, et pour vérifier régulièrement le solde ou le trafic restant, une requête par minute est suffisante pour rester dans la limite.
{"ok":false,"error":"unauthorized"}