प्रॉक्सी API दस्तावेज़ और कनेक्शन विधियाँ

IPKite रेजिडेंशियल प्रॉक्सी को कोड और टूल्स से कनेक्ट करने का तरीका, और बैलेंस, खरीद इतिहास, प्रॉक्सी सूची को देखने के लिए डेवलपर API को उदाहरणों के साथ समझाया गया है।

API कुंजी प्राप्त करें

रिजिडेंशियल प्रॉक्सी त्वरित शुरुआत

जब आप residential proxy खरीदते हैं, तो आपके सदस्य पृष्ठ पर proxy username और पासवर्ड दिखाई देता है। कनेक्शन का पता एक ही होता है, और username में जोड़े गए मान से देश, शहर और सत्र निर्धारित किया जाता है। नीचे दिए गए कमांड की एक पंक्ति से आप कनेक्शन को तुरंत जांच सकते हैं।

खरीदारी: सदस्य स्क्रीन पर वांछित GB चुनकर रेजिडेंशियल प्रॉक्सी खरीदें।
पुष्टि करें: सदस्य पृष्ठ पर प्रॉक्सी उपयोगकर्ता नाम (USERNAME) और पासवर्ड (PASSWORD) की जांच करें।
कनेक्शन: gw.ipkite.com एड्रेस और HTTP 7000 या SOCKS5 7100 पोर्ट पर रिक्वेस्ट भेजें।

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

प्रॉक्सी कनेक्शन जानकारी प्रारूप

सभी रेजिडेंशियल प्रॉक्सी कनेक्शन एक ही पते का उपयोग करते हैं। HTTP और HTTPS अनुरोध 7000 पोर्ट पर भेजे जाते हैं, और SOCKS5 कनेक्शन 7100 पोर्ट पर भेजे जाते हैं। उपयोगकर्ता नाम के बाद हाइफ़न (-) से पैरामीटर जोड़ें, और केवल आवश्यक पैरामीटर चुनें।

आइटम	मूल्य	विवरण
पता	gw.ipkite.com	सभी रेजिडेंशियल प्रॉक्सी कनेक्शन का कनेक्शन पता
HTTP/HTTPS पोर्ट	7000	HTTP प्रॉक्सी के साथ HTTP और HTTPS साइट्स से कनेक्ट करें
SOCKS5 पोर्ट	7100	SOCKS5 का समर्थन करने वाले टूल और ऐप्स से कनेक्ट करें
cc	दो अक्षरों का देश कोड (छोटे अक्षरों में)	उदाहरण: cc-us, cc-gb, cc-de
city	शहर का नाम (लोअरकेस, बिना स्पेस के)	उदाहरण: city-newyork, city-london
sess	अंग्रेजी/न्यूमेरिक सेशन नाम	एक ही मान का उपयोग करते हुए एक ही IP बनाए रखें
ttl	1 से 1,440 (मिनट)	स्थिर सत्र को बनाए रखने का समय

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

रोटेटिंग प्रॉक्सी और स्टिकी सत्र उदाहरण

यूजरनेम में sess वैल्यू नहीं डालने पर हर रिक्वेस्ट पर नया IP मिलेगा (रोटेटिंग प्रॉक्सी)। sess और ttl डालने पर निर्धारित समय (1-1440 मिनट) तक एक ही IP रहेगा (स्टिकी सेशन)। नया IP चाहिए तो 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/

देश/शहर टार्गेटिंग उदाहरण

cc पैरामीटर का उपयोग करके 174 देशों और क्षेत्रों में से एक चुनें, और city पैरामीटर का उपयोग करके प्रमुख शहरों तक सीमित करें। देश और शहर टारगेटिंग का उपयोग रोटेटिंग और स्टिकी सत्र दोनों में किया जा सकता है।

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

Python requests प्रॉक्सी उदाहरण

Python requests में, proxies मान में HTTP और HTTPS दोनों के लिए एक ही प्रॉक्सी पता डालें। SOCKS5 से कनेक्ट करने के लिए requests[socks] इंस्टॉल करें और पते को 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 प्रॉक्सी उदाहरण

Node.js में, undici का ProxyAgent या https-proxy-agent पैकेज का उपयोग करके कनेक्ट करें। दोनों तरीकों में केवल प्रॉक्सी पता डालना होता है।

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

डेवलपर API प्रमाणीकरण और बेस एड्रेस

डेवलपर API REST तरीके से काम करता है और सभी प्रतिक्रियाएं JSON में होती हैं। अकाउंट स्क्रीन से API कुंजी जारी करने पर ipk_live_ से शुरू होने वाली कुंजी केवल एक बार दिखाई जाती है, इसलिए इसे तुरंत सुरक्षित स्थान पर सहेजें। सभी अनुरोधों के Authorization हेडर में Bearer और API कुंजी डालें।

मूल पता: https://ipkite.com/api/v1
ऑथेंटिकेशन हेडर: Authorization: Bearer <API key>
कॉल सीमा: 1 मिनट में 120 बार
रिस्पॉन्स फॉर्मेट: JSON, सफलता पर "ok": true

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

डेवलपर API एंडपॉइंट

मेथड	पथ	विषय	मुख्य प्रतिक्रिया मान
GET	/balance	वर्तमान बैलेंस	balance, currency
GET	/orders	खरीद विवरण सूची	code, product, summary, amount, status, created_at
GET	/proxies	खरीदे गए प्रॉक्सी सूची	residential: username, password, host, http_port, socks_port, traffic_gb_left / स्थिर IP: ip, port, username, password, country, expires_at

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

API त्रुटि प्रतिक्रिया और कॉल सीमा

यदि API कुंजी गायब है या मेल नहीं खाती है, तो HTTP 401 के साथ नीचे दी गई प्रतिक्रिया मिलेगी। हेडर नाम और Bearer के बाद की जगह, और पूरी कुंजी शामिल है यह सुनिश्चित करें। कॉल सीमा 1 मिनट में 120 बार है, और बैलेंस या शेष ट्रैफ़िक की नियमित जांच के लिए, 1 मिनट में एक बार जांच करने से सीमा के भीतर आसानी से उपयोग किया जा सकता है।

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