API สำหรับนักพัฒนาแผน IP
REST API ขนาดเล็กที่มีคำตอบเป็น JSON: อ่านแผน, ประเทศ และราคาที่แน่นอนโดยไม่ต้องใช้คีย์ และตรวจสอบเครดิตและซื้อแผนด้วย API key ของคุณ ทุกคำตอบมี 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
}
}คำสั่งซื้อใหม่เริ่มต้นเป็น processing และเปลี่ยนเป็น active เมื่อบริการพร้อม จากนั้นการเข้าถึงจะเก็บรหัสล็อกอิน (แผนแอป), รายการ proxy และผู้ใช้ (แผน proxy) หรือที่อยู่ Remote Desktop (cloud PCs) โพล 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 คีย์จะแสดงเพียงครั้งเดียวและเก็บไว้เป็นแฮชเท่านั้น; การแทนที่คีย์จะหยุดคีย์เก่าทันที