API для розробників IP-тарифів

Невеликий REST API з відповідями у форматі JSON: переглядайте тарифи, країни та точні ціни без ключа, а також перевіряйте баланс і купуйте тарифи за допомогою вашого 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 (хмарні ПК). Отримуйте 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. Ключ показується один раз і зберігається лише у вигляді хешу; заміна ключа негайно блокує старий.