API
JSON su HTTPS. Invia la chiave API nell'header Authorization. Fino a 300 richieste al minuto.
Indirizzo base
https://wingproxy.com/api/v1
Autenticazione
Header Authorization: Bearer YOUR_API_KEY. Crea la chiave nella pagina Chiave API dopo la prima ricarica.
curl https://wingproxy.com/api/v1/account \ -H "Authorization: Bearer YOUR_API_KEY"
GET /account
Saldo e traffico.
Esempio di risposta
{
"balance": "42.50",
"traffic_left_gb": "8.73",
"traffic_used_gb": "1.27"
}GET /prices
Prezzo per GB per ogni dimensione di pacchetto.
Esempio di risposta
[
{ "from_gb": 1, "per_gb": "4.00" },
{ "from_gb": 10, "per_gb": "3.50" }
]POST /traffic {"gb": 10}
Acquista traffico dal tuo saldo.
Esempio di risposta
{
"id": 311,
"gb": 10,
"price": "35.00",
"status": "added"
}GET /list?country=de&session=sticky&minutes=10&count=5&format=hostport
Crea righe proxy. country: un codice paese, o vuoto per qualsiasi. session: rotating (predefinito) o sticky. minutes: da 1 a 120 (predefinito 10, solo sticky). count: da 1 a 1000 (predefinito 10). format: hostport (host:port:user:pass, predefinito) o url (user:pass@host:port). protocol: http (predefinito) o socks5.
Esempio di risposta
{
"lines": [ "gate.example:8000:user-country-de-session-a1b2-time-10:pass" ]
}GET /usage
Traffico giornaliero degli ultimi 30 giorni.
Esempio di risposta
[
{ "day": "2026-10-13", "gb": "0.84" }
]Errori
Gli errori restituiscono uno stato diverso da 2xx e un corpo JSON con un codice di errore.
| unauthorized | Chiave API mancante o errata |
| not_allowed | L'API si apre dopo la prima ricarica |
| bad_request | Un campo è mancante o errato |
| not_enough_balance | Prima ricarica |
| not_added | Non è stato possibile aggiungere il traffico; il prezzo è tornato sul saldo |
| checking | Conferma in attesa; verifichiamo e aggiungiamo il traffico o restituiamo il prezzo |
| no_login | Prima acquista traffico; il login proxy viene creato allora |
| rate_limited | Troppe richieste in un minuto |
