Dokumentacja API proxy i metody połączenia
Instrukcje podłączenia proxy mieszkaniowych IPKite do kodu i narzędzi oraz API dla developerów do sprawdzania salda, historii zakupów i listy proxy - z przykładami.
Szybki start z proxy mieszkaniowymi
Po zakupie proxy residentialowego na Twoim koncie pojawią się dane logowania: nazwa użytkownika i hasło. Jeden adres połączenia, a kraj, miasto i sesję określasz poprzez parametry w nazwie użytkownika. Sprawdź połączenie tym jednym poleceniem:
- Zakup: Wybierz potrzebną ilość GB proxy rezydencjalnych w panelu użytkownika.
- Sprawdź: w panelu użytkownika znajdziesz nazwę użytkownika (USERNAME) i hasło (PASSWORD) proxy.
- Połączenie: wysyłaj żądania na adres gw.ipkite.com i port HTTP 7000 lub SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Format danych połączenia proxy
Wszystkie połączenia residential proxy używają tego samego adresu. Żądania HTTP i HTTPS są wysyłane na port 7000, a połączenia SOCKS5 na port 7100. Do nazwy użytkownika możesz dodać parametry z myślnikiem (-), wybierając tylko te, których potrzebujesz.
| Pozycja | Wartość | Opis |
|---|---|---|
| Adres | gw.ipkite.com | Adres połączenia dla wszystkich residential proxy |
| Porty HTTP/HTTPS | 7000 | Łączenie się z witrynami HTTP i HTTPS przez proxy HTTP |
| Port SOCKS5 | 7100 | Połącz się w narzędziach i aplikacjach obsługujących SOCKS5 |
| cc | Dwuliterowy kod kraju (małe litery) | Przykład: cc-us, cc-gb, cc-de |
| city | Nazwa miasta (małe litery, bez spacji) | Przykład: city-newyork, city-london |
| sess | Nazwa sesji w języku angielskim i cyfrach | Utrzymywanie tego samego IP przy tej samej wartości |
| ttl | 1~1,440 (minut) | Czas utrzymania stałej sesji |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Przykłady proxy rotacyjnego i sesji stałej
Jeśli nie dodasz wartości sess do nazwy użytkownika, będzie działać jako rotacyjny proxy, przypisujący nowy adres IP przy każdym żądaniu. Dodając sess i ttl, otrzymasz stałą sesję z tym samym adresem IP przez określony czas (1-1,440 minut). Gdy potrzebny jest nowy adres IP, wystarczy zmienić wartość sess.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Przykład targetingu kraju i miasta
Użyj parametru cc, aby wybrać jeden z 174 krajów/regionów, i parametru city, aby zawęzić do głównych miast. Targetowanie kraju i miasta można używać zarówno w sesjach rotacyjnych, jak i stałych.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Przykład proxy w Python requests
W Python requests użyj tej samej wartości proxy dla HTTP i HTTPS w parametrze proxies. Aby połączyć się przez SOCKS5, zainstaluj requests[socks] i zmień adres na 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)Przykład proxy w Node.js
W Node.js możesz użyć ProxyAgent z undici lub pakietu https-proxy-agent. Obie metody wymagają tylko jednej linii z adresem 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);Autoryzacja API i podstawowy adres
API dla developerów działa w standardzie REST, a wszystkie odpowiedzi są w formacie JSON. Po wygenerowaniu klucza API w panelu konta, klucz zaczynający się od ipk_live_ jest wyświetlany tylko raz - zapisz go w bezpiecznym miejscu. Każde żądanie musi zawierać nagłówek Authorization z wartością Bearer i kluczem API.
- Adres podstawowy: https://ipkite.com/api/v1
- Nagłówek autoryzacji: Authorization: Bearer <API key>
- Limit wywołań: 120 na minutę
- Format odpowiedzi: JSON, jeśli sukces, "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Endpoint API dla developerów
| Metoda | Ścieżka | Treść | Główne wartości odpowiedzi |
|---|---|---|---|
| GET | /balance | Aktualne saldo | balance, currency |
| GET | /orders | Lista zakupów | code, product, summary, amount, status, created_at |
| GET | /proxies | Lista zakupionych proxy | Residential: username, password, host, http_port, socks_port, traffic_gb_left / Stałe IP: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Błędy API i limity wywołań
Jeśli klucz API jest brakujący lub nieprawidłowy, otrzymasz odpowiedź HTTP 401. Sprawdź nazwę nagłówka, spację po Bearer i czy cały klucz jest obecny. Limit wywołań to 120 na minutę, a sprawdzanie salda lub pozostałego ruchu raz na minutę pozwala na komfortowe korzystanie w ramach limitu.
{"ok":false,"error":"unauthorized"}