API dành cho nhà phát triển các gói IP

API REST nhỏ với phản hồi JSON: xem gói dịch vụ, quốc gia và giá chính xác không cần khóa, kiểm tra số dư và mua gói bằng API key. Mọi phản hồi đều có ok: true hoặc false.

URL cơ sở: https://proxyworld.cc/api/v1
Xác thực: Authorization: Bearer pwk_...
Định dạng: JSON over HTTPS
Giới hạn: 300 yêu cầu mỗi phút mỗi khóa

Điểm cuối

Phương thức	Đường dẫn	Khóa	Chức năng
GET	/plans	Không	Tất cả gói dịch vụ với giá đơn vị mỗi 30 ngày, giá theo số lượng, số lượng tối thiểu/tối đa và quốc gia áp dụng.
GET	/countries	Không	24 quốc gia với đường truyền khu vực, thành phố và khả năng triển khai đám mây.
GET	/price?plan=rotate-max&quantity=2&days=90	Không	Tổng chính xác cho một gói, số lượng và thời hạn (30, 90, 180 hoặc 360 ngày).
GET	/balance	Có	Số dư tài khoản bằng USD.
POST	/orders	Có	Mua gói từ số dư. Nội dung: gói, số lượng, ngày, quốc gia (cho các gói yêu cầu).
GET	/orders	Có	100 đơn hàng gần nhất với trạng thái và thông tin truy cập.
GET	/orders/{id}	Có	Một đơn hàng theo mã (PO-...).

Ví dụ

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

Phản hồi từ 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
  }
}

Đơn hàng mới bắt đầu ở trạng thái xử lý và chuyển thành hoạt động khi dịch vụ sẵn sàng; thông tin truy cập sau đó chứa mã đăng nhập (gói ứng dụng), danh sách proxy và người dùng (gói proxy) hoặc địa chỉ Remote Desktop (máy tính đám mây). Kiểm tra GET /orders/{id} mỗi vài giây cho đến khi thay đổi.

Lỗi

HTTP	lỗi	Ý nghĩa
400	bad_plan, bad_qty, bad_days, bad_country	Yêu cầu được kiểm tra trước khi tính phí bất cứ thứ gì.
401	unauthorized	Gửi tiêu đề Authorization: Bearer pwk_...
402	funds	Số dư thấp hơn giá; câu trả lời bao gồm need, số tiền còn thiếu. Không có gì bị tính phí.
429	rate_limited	Hơn 300 yêu cầu trong một phút trên một khóa.
503	network	Dịch vụ không thể thiết lập ngay bây giờ; không có gì bị tính phí. Thử lại sau.

Tạo hoặc thay thế khóa của bạn trong bảng điều khiển dưới mục API. Khóa được hiển thị một lần và chỉ được lưu trữ dưới dạng băm; thay thế nó sẽ dừng khóa cũ ngay lập tức.