Documentazione API proxy
L'API REST consente al tuo codice di verificare i prezzi, controllare il credito e i GB rimanenti, acquistare traffico e ottenere le credenziali proxy. JSON su HTTPS, una chiave Bearer per account, generata nella pagina delle chiavi API del pannello di controllo.
URL base
https://gbproxies.cc/api/v1Autenticazione
Authorization: Bearer gbk_...Limite300 richieste al minuto per chiave
Endpoint
GET /productsChiave: NoProdotti, prezzi per GB con passi di volume, porte e opzioni di targeting.GET /locations?product=residentialChiave: NoPaesi e IP unici visti in 30 giorni per un prodotto.GET /balanceChiave: SìIl tuo credito in USD e i GB acquistati, usati e rimanenti per prodotto.GET /proxyChiave: SìHost gateway, nome utente e password del proxy e le porte di ogni prodotto.POST /ordersChiave: SìAcquista traffico: corpo JSON {"product": "residential", "gb": 50}. Pagato dal credito.GET /ordersChiave: SìI tuoi ultimi 50 acquisti.Esempi
Un acquisto restituisce l'ID dell'ordine, i GB aggiunti e il prezzo. Recupera le credenziali proxy una volta con GET /proxy e riutilizzale; non cambiano tra un acquisto e l'altro.
{
"ok": true,
"id": "GO-7K2MQX9PLA",
"product": "residential",
"gb": 50,
"price_usd": "30.00",
"state": "added"
}curl https://gbproxies.cc/api/v1/products
curl -H "Authorization: Bearer gbk_YOUR_KEY" https://gbproxies.cc/api/v1/balance
curl -X POST -H "Authorization: Bearer gbk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"product":"residential","gb":50}' https://gbproxies.cc/api/v1/ordersimport requests
H = {"Authorization": "Bearer gbk_YOUR_KEY"}
print(requests.get("https://gbproxies.cc/api/v1/balance", headers=H).json())
r = requests.post("https://gbproxies.cc/api/v1/orders", headers=H, json={"product": "residential", "gb": 50})
print(r.status_code, r.json())const H = { Authorization: "Bearer gbk_YOUR_KEY", "Content-Type": "application/json" };
console.log(await (await fetch("https://gbproxies.cc/api/v1/balance", { headers: H })).json());
const r = await fetch("https://gbproxies.cc/api/v1/orders", { method: "POST", headers: H, body: JSON.stringify({ product: "residential", gb: 50 }) });
console.log(r.status, await r.json());Errori
Ogni risposta include ok. Gli errori aggiungono error (un codice stabile) e message. Nessun addebito viene effettuato in caso di errore.
unauthorized401Chiave API mancante o errata.bad_product400ID prodotto sconosciuto.bad_gb400GB al di fuori del minimo e massimo del prodotto.funds402Credito insufficiente. need_usd indica quanto aggiungere. Non viene addebitato nulla.network503Il traffico non può essere aggiunto in questo momento. Nessun addebito è stato effettuato; riprova più tardi.rate_limited429Più di 300 richieste al minuto su una singola chiave.