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