ProxyWorld
HI

IP प्लान के लिए डेवलपर API

JSON उत्तरों के साथ एक छोटा REST API: बिना कुंजी के प्लान, देश और सटीक कीमतें पढ़ें, और अपने API कुंजी के साथ क्रेडिट जांचें और प्लान खरीदें। हर उत्तर में ok: true या false होता है।

बेस URL
https://proxyworld.cc/api/v1
प्रमाणीकरण
Authorization: Bearer pwk_...
प्रारूप
JSON over HTTPS
सीमा
प्रति कुंजी प्रति मिनट 300 अनुरोध

एंडपॉइंट्स

मेथडपथकुंजीयह क्या करता है
GET/plansनहींसभी प्लान प्रति 30 दिनों की इकाई कीमत, वॉल्यूम कीमतें, न्यूनतम और अधिकतम मात्रा और अनुमत देशों के साथ।
GET/countriesनहीं24 देश क्षेत्र लाइन, शहर और क्लाउड उपलब्धता के साथ।
GET/price?plan=rotate-max&quantity=2&days=90नहींएक प्लान, मात्रा और अवधि (30, 90, 180 या 360 दिन) के लिए सटीक कुल।
GET/balanceहाँअमेरिकी डॉलर में खाते पर क्रेडिट।
POST/ordersहाँक्रेडिट से एक प्लान खरीदें। बॉडी: प्लान, मात्रा, दिन, देश (उन प्लान के लिए जो एक लेते हैं)।
GET/ordersहाँआपके अंतिम 100 ऑर्डर स्थिति और पहुंच विवरण के साथ।
GET/orders/{id}हाँइसके कोड (PO-...) द्वारा एक ऑर्डर।

उदाहरण

cURL

curl -s https://proxyworld.cc/api/v1/price?plan=static-ip\&quantity=10\&days=30

curl -s -X POST https://proxyworld.cc/api/v1/orders \
  -H "Authorization: Bearer pwk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"static-ip","quantity":10,"days":30,"country":"DE"}'

Python

import requests
KEY = "pwk_YOUR_KEY"
r = requests.post("https://proxyworld.cc/api/v1/orders",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"plan": "rotate-max", "quantity": 2, "days": 90})
print(r.status_code, r.json())

Node.js

const r = await fetch("https://proxyworld.cc/api/v1/orders", {
  method: "POST",
  headers: { Authorization: "Bearer pwk_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ plan: "cloud-pc-b", quantity: 2, days: 30, country: "NL" }),
});
console.log(r.status, await r.json());

POST /orders का उत्तर

{
  "ok": true,
  "order": {
    "id": "PO-7KQ2M9XHTA",
    "product": "static",
    "plan": "static-ip",
    "quantity": 10,
    "days": 30,
    "country": "DE",
    "price": "40.20",
    "status": "processing",
    "status_text": "Setting up",
    "created_at": "2026-11-05T09:00:00.000Z",
    "active_at": null,
    "ends_at": null,
    "access": null
  }
}

एक नया ऑर्डर प्रोसेसिंग के रूप में शुरू होता है और सेवा तैयार होने पर सक्रिय हो जाता है; पहुंच तब लॉगिन कोड (ऐप प्लान), प्रॉक्सी सूची और उपयोगकर्ता (प्रॉक्सी प्लान) या Remote Desktop पते (क्लाउड PC) रखता है। हर कुछ सेकंड में GET /orders/{id} पोल करें जब तक यह बदल न जाए।

त्रुटियाँ

HTTPत्रुटिअर्थ
400bad_plan, bad_qty, bad_days, bad_countryकिसी भी चार्ज से पहले अनुरोध की जाँच की जाती है।
401unauthorizedहेडर Authorization: Bearer pwk_... भेजें
402fundsक्रेडिट कीमत से कम है; उत्तर में need, गायब राशि शामिल है। कुछ भी चार्ज नहीं किया जाता है।
429rate_limitedएक मिनट में एक कुंजी पर 300 से अधिक अनुरोध।
503networkसेवा को अभी सेटअप नहीं किया जा सका; कुछ भी चार्ज नहीं किया गया। बाद में फिर से प्रयास करें।

कंसोल में API के तहत अपनी कुंजी बनाएं या बदलें। कुंजी केवल एक बार दिखाई जाती है और केवल हैश के रूप में संग्रहीत की जाती है; इसे बदलने से पुरानी कुंजी तुरंत बंद हो जाती है।

प्रॉक्सी और IP API: योजनाएं, कीमतें, ऑर्डर और बैलेंस (REST)