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
  }
}

Новый заказ начинается как processing и становится active, когда сервис готов; доступ затем содержит код входа (планы приложений), список прокси и пользователя (планы прокси) или адреса 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. Ключ показывается один раз и хранится только в виде хэша; замена ключа немедленно блокирует старый ключ.