Proxy API Dokümantasyonu ve Bağlantı Yöntemleri

IPKite konut proxy'yi kodunuza ve araçlarınıza nasıl bağlayacağınızı, ayrıca bakiye/satın alma geçmişi/proxy listesini sorgulamak için geliştirici API'sini örneklerle birlikte öğrenin.

API anahtarı al

Residential proxy hızlı başlangıç

Residential proxy satın aldığınızda, hesap ekranınızda proxy kullanıcı adı ve şifreniz görüntülenir. Bağlantı adresi tektir, kullanıcı adına eklenen değerlerle ülke, şehir ve oturum belirlenir. Aşağıdaki tek komutla bağlantınızı hemen test edebilirsiniz.

Satın alma: Üye panelinden istediğiniz GB miktarını seçerek residential proxy satın alabilirsiniz.
Kontrol: Üye panelinde proxy kullanıcı adını (USERNAME) ve şifresini (PASSWORD) kontrol edin.
Bağlantı: gw.ipkite.com adresi ve HTTP 7000 veya SOCKS5 7100 portu üzerinden istek gönderin.

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

Proxy Bağlantı Bilgisi Formatı

Tüm residential proxy bağlantıları aynı adresi kullanır. HTTP ve HTTPS istekleri 7000 numaralı porttan, SOCKS5 bağlantıları 7100 numaralı porttan gönderilir. Kullanıcı adının sonuna istediğiniz parametreleri tire (-) ile ekleyebilirsiniz.

Madde	Değer	Açıklama
Adres	gw.ipkite.com	Tüm residential proxy bağlantılarının bağlantı adresi
HTTP/HTTPS portu	7000	HTTP proxy ile HTTP ve HTTPS sitelerine bağlanma
SOCKS5 Port	7100	SOCKS5 destekleyen araçlar ve uygulamalarla bağlanın
cc	İki harfli ülke kodu (küçük harf)	Örnek: cc-us, cc-gb, cc-de
city	Şehir adı (küçük harf, boşluk yok)	Örnek: city-newyork, city-london
sess	İngilizce·sayısal oturum adı	Aynı değer kullanıldığı sürece aynı IP korunur
ttl	1-1,440 (dakika)	Sabit oturumun süresi

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

Dönen proxy ve sabit oturum örnekleri

Kullanıcı adına sess değeri eklemezseniz her istekte yeni IP atanan dönen proxy olarak çalışır. sess ve ttl eklerseniz, ttl ile belirlenen süre (1-1,440 dakika) boyunca aynı IP korunur. Yeni IP gerektiğinde sess değerini değiştirmeniz yeterlidir.

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

Ülke/şehir hedefleme örneği

cc parametresiyle 174 ülke·bölgeden birini seçin ve city parametresiyle ana şehirleri daraltın. Ülke·şehir hedefleme, döner ve sabit oturumlarla birlikte kullanılabilir.

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

Python requests Proxy Örneği

Python requests'te proxies değerine hem HTTP hem HTTPS için aynı proxy adresini ekleyin. SOCKS5 ile bağlanmak için requests[socks]'u kurun ve adresi socks5h:// olarak değiştirin.

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 Örneği

Node.js'de undici'nin ProxyAgent'ı veya https-proxy-agent paketiyle bağlanın. Her iki yöntemde de proxy adresi tek satırda eklenir.

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);

Geliştirici API kimlik doğrulaması ve temel adres

Geliştirici API REST tabanlıdır ve tüm yanıtlar JSON formatındadır. Hesap ekranından bir API anahtarı oluşturduğunuzda, ipk_live_ ile başlayan anahtar sadece bir kez gösterilir, bu nedenle hemen güvenli bir yere kaydedin. Tüm isteklerin Authorization başlığına Bearer ve API anahtarını ekleyin.

Temel adres: https://ipkite.com/api/v1
Kimlik doğrulama başlığı: Authorization: Bearer <API anahtarı>
Çağrı limiti: Dakikada 120 kez
Yanıt formatı: JSON, başarı durumunda "ok": true

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

Geliştirici API uç noktaları

Yöntem	Yol	İçerik	Temel yanıt değerleri
GET	/balance	Mevcut bakiye	balance, currency
GET	/orders	Satın alma detayları listesi	code, product, summary, amount, status, created_at
GET	/proxies	Satın alınan proxy listesi	Residential: username, password, host, http_port, socks_port, traffic_gb_left / Sabit IP: ip, port, username, password, country, expires_at

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

API hata yanıtları ve çağrı limitleri

API anahtarı yoksa veya yanlışsa HTTP 401 ile aşağıdaki yanıt döner. Başlık adını, Bearer sonrası boşluğu ve anahtarın tamamının girildiğini kontrol edin. Çağrı limiti dakikada 120'dir ve bakiye veya kalan trafiği düzenli olarak kontrol ederken dakikada bir kez sorgulama yaparak limitler dahilinde rahatça kullanabilirsiniz.

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