API per sviluppatori per piani IP

Una piccola API REST con risposte JSON: leggi piani, paesi e prezzi esatti senza una chiave, e controlla il credito e acquista piani con la tua chiave API. Ogni risposta ha ok: true o false.

URL di base: https://proxyworld.cc/api/v1
Autenticazione: Authorization: Bearer pwk_...
Formato: JSON over HTTPS
Limite: 300 richieste al minuto per chiave

Endpoint

Metodo	Percorso	Chiave	Cosa fa
GET	/plans	No	Tutti i piani con prezzo unitario per 30 giorni, prezzi volume, quantità minima e massima e paesi consentiti.
GET	/countries	No	I 24 paesi con linea regionale, città e disponibilità cloud.
GET	/price?plan=rotate-max&quantity=2&days=90	No	Totale esatto per un piano, quantità e periodo (30, 90, 180 o 360 giorni).
GET	/balance	Sì	Credito sul conto in dollari statunitensi.
POST	/orders	Sì	Acquista un piano dal credito. Body: piano, quantità, giorni, paese (per piani che lo richiedono).
GET	/orders	Sì	I tuoi ultimi 100 ordini con stato e dettagli di accesso.
GET	/orders/{id}	Sì	Un ordine tramite il suo codice (PO-...).

Esempi

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

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

Un nuovo ordine inizia come processing e diventa active quando il servizio è pronto; l'accesso contiene quindi il codice di accesso (piani app), la lista proxy e utente (piani proxy) o gli indirizzi Remote Desktop (cloud PC). Poll GET /orders/{id} ogni pochi secondi fino a quando cambia.

Errori

HTTP	errore	Significato
400	bad_plan, bad_qty, bad_days, bad_country	La richiesta viene verificata prima di qualsiasi addebito.
401	unauthorized	Invia l'header Authorization: Bearer pwk_...
402	funds	Il credito è inferiore al prezzo; la risposta include need, l'importo mancante. Nessun addebito viene effettuato.
429	rate_limited	Più di 300 richieste in un minuto con una singola chiave.
503	network	Impossibile configurare il servizio al momento; nessun addebito. Riprova più tardi.

Crea o sostituisci la tua chiave nella console sotto API. La chiave viene mostrata una volta e memorizzata solo come hash; sostituirla disattiva immediatamente la vecchia chiave.