আইপি প্ল্যানের জন্য ডেভেলপার 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
}
}একটি নতুন অর্ডার প্রসেসিং হিসাবে শুরু হয় এবং পরিষেবা প্রস্তুত হলে সক্রিয় হয়ে যায়; অ্যাক্সেস তখন লগইন কোড (অ্যাপ প্ল্যান), প্রক্সি তালিকা এবং ব্যবহারকারী (প্রক্সি প্ল্যান) বা রিমোট ডেস্কটপ অ্যাড্রেস (ক্লাউড পিসি) ধারণ করে। GET /orders/{id} প্রতি কয়েক সেকেন্ডে পোল করুন যতক্ষণ না এটি পরিবর্তিত হয়।
ত্রুটি
| HTTP | ত্রুটি | অর্থ |
|---|---|---|
| 400 | bad_plan, bad_qty, bad_days, bad_country | চার্জ করার আগে অনুরোধটি পরীক্ষা করা হয়। |
| 401 | unauthorized | Authorization: Bearer pwk_... হেডার পাঠান |
| 402 | funds | ক্রেডিট মূল্যের চেয়ে কম; উত্তরে প্রয়োজন, অনুপস্থিত পরিমাণ অন্তর্ভুক্ত। কিছুই চার্জ করা হয় না। |
| 429 | rate_limited | এক মিনিটে একটি কীতে 300 টির বেশি অনুরোধ। |
| 503 | network | সেবাটি এখনই সেট আপ করা যায়নি; কিছুই চার্জ করা হয় না। পরে আবার চেষ্টা করুন। |
কনসোলের API বিভাগে আপনার কী তৈরি বা প্রতিস্থাপন করুন। কীটি একবার দেখানো হয় এবং শুধুমাত্র হ্যাশ হিসাবে সংরক্ষণ করা হয়; এটি প্রতিস্থাপন করলে পুরানো কীটি সাথে সাথে বন্ধ হয়ে যায়।