API dla deweloperów planów IP

Małe REST API z odpowiedziami w JSON: przeglądaj plany, kraje i dokładne ceny bez klucza, oraz sprawdzaj saldo i kupuj plany za pomocą klucza API. Każda odpowiedź zawiera ok: true lub false.

Podstawowy URL: https://proxyworld.cc/api/v1
Uwierzytelnianie: Authorization: Bearer pwk_...
Format: JSON over HTTPS
Limit: 300 żądań na minutę na klucz

Endpointy

Metoda	Ścieżka	Klucz	Funkcja
GET	/plans	Nie	Wszystkie plany z ceną jednostkową za 30 dni, cenami hurtowymi, minimalną i maksymalną ilością oraz dozwolonymi krajami.
GET	/countries	Nie	24 kraje z linią regionalną, miastami i dostępnością w chmurze.
GET	/price?plan=rotate-max&quantity=2&days=90	Nie	Dokładna suma za plan, ilość i okres (30, 90, 180 lub 360 dni).
GET	/balance	Tak	Saldo na koncie w dolarach amerykańskich.
POST	/orders	Tak	Kup plan z salda. Ciało: plan, ilość, dni, kraj (dla planów, które go wymagają).
GET	/orders	Tak	Twoje ostatnie 100 zamówień ze statusem i danymi dostępu.
GET	/orders/{id}	Tak	Jedno zamówienie według jego kodu (PO-...).

Przykłady

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

Odpowiedź na 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
  }
}

Nowe zamówienie zaczyna się jako przetwarzane i staje się aktywne, gdy usługa jest gotowa; dostęp zawiera wtedy kod logowania (plany aplikacji), listę proxy i użytkownika (plany proxy) lub adresy Remote Desktop (chmurowe PC). Sprawdzaj GET /orders/{id} co kilka sekund, aż się zmieni.

Błędy

HTTP	błąd	Znaczenie
400	bad_plan, bad_qty, bad_days, bad_country	Żądanie jest sprawdzane przed naliczeniem opłaty.
401	unauthorized	Wyślij nagłówek Authorization: Bearer pwk_...
402	funds	Saldo jest niższe niż cena; odpowiedź zawiera 'need', brakującą kwotę. Nic nie jest pobierane.
429	rate_limited	Ponad 300 żądań w ciągu minuty na jeden klucz.
503	network	Usługa nie mogła zostać skonfigurowana w tej chwili; nic nie jest pobierane. Spróbuj ponownie później.

Utwórz lub zastąp swój klucz w konsoli w sekcji API. Klucz jest wyświetlany tylko raz i przechowywany jako hash; jego zastąpienie natychmiast unieważnia stary klucz.