Questa guida mostra come acquistare nuovi proxy tramite l'API da zero: controllare la disponibilità, calcolare il prezzo, effettuare l'ordine e recuperare gli IP acquistati.
Ogni richiesta usa la tua chiave API personale dalla dashboard del tuo account (come ottenere la chiave API). Negli esempi qui sotto, sostituisci YOUR_API_KEY con la tua chiave. Per pagare con il saldo del tuo account, usa paymentId = 1.
⚠️ Il passaggio dell'ordine addebita il tuo saldo. Verifica sempre prima il costo nel passaggio di calcolo.
Il flusso in breve
Controlla il saldo.
Verifica cosa si può ordinare (paese, periodo).
Scegli un metodo di pagamento (o usa il saldo).
Calcola il prezzo.
Effettua l'ordine.
Recupera i proxy acquistati.
Passo 1 — Controlla il saldo
Assicurati di avere saldo sufficiente per l'acquisto.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Risposta
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Passo 2 — Verifica cosa si può ordinare
La Reference List restituisce tutto il necessario per ordinare: paesi, periodi, target, operatori e rotazioni (per mobile). Copia il countryId e il periodId che ti servono.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}
Parametri del percorso
Nome | Valore | Descrizione |
type |
| Il tipo di proxy (ipv4, ipv6, mobile, isp, mix, mix_isp). |
Esempio
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4
Risposta
{
"status": "success",
"data": {
"items": [
{
"country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
"period": [ { "id": "1m", "name": "1 month" } ]
}
]
},
"errors": []
}
Passo 3 — Scegli un metodo di pagamento
Elenca i sistemi di pagamento disponibili e copia l'id desiderato come paymentId. Per pagare con il saldo, usa semplicemente paymentId = 1.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Risposta
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
Passo 4 — Calcola il prezzo
Calcola il prezzo dell'ordine prima di acquistare. Gli sconti per volume e periodo di noleggio si applicano come sul sito. Questo passaggio non addebita nulla.
I campi del body dipendono dal tipo di proxy. I campi comuni sono sotto; per IPv6 passa anche protocol, per mobile operatorId + rotationId, per residential usa tarifId — tutto dalla Reference List.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Corpo della richiesta
Nome | Tipo | Descrizione |
countryId | Number | ID del paese dalla Reference List (passo 2). |
periodId | String | ID del periodo di noleggio dalla Reference List. |
quantity | Number | Il numero di proxy da ordinare. |
paymentId | Number | ID del sistema di pagamento. |
coupon (opzionale) | String | Un codice coupon, se ne hai uno. |
authorization (opzionale) | String | Metodo di autorizzazione. Lascia vuoto per usare login:password. |
customTargetName (opzionale) | String | Un nome di target personalizzato, se necessario. |
Esempio
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Risposta — shows the total, your balance, the discount and the per-proxy price:
{
"status": "success",
"data": {
"warning": "",
"balance": 2000,
"total": 9,
"quantity": 5,
"currency": "USD",
"discount": 0.45,
"price": 1.8
},
"errors": []
}
Passo 5 — Effettua l'ordine (addebita il tuo saldo)
Quando il prezzo calcolato è corretto, effettua l'ordine. Questo passaggio addebita il tuo saldo. Usa gli stessi parametri del passo 4. Copia l'orderId dalla risposta.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Corpo della richiesta
Nome | Tipo | Descrizione |
countryId | Number | ID del paese dalla Reference List (passo 2). |
periodId | String | ID del periodo di noleggio dalla Reference List. |
quantity | Number | Il numero di proxy da ordinare. |
paymentId | Number | ID del sistema di pagamento. |
coupon (opzionale) | String | Un codice coupon, se ne hai uno. |
authorization (opzionale) | String | Metodo di autorizzazione. Lascia vuoto per usare login:password. |
generateAuth (opzionale) | String | Y/N — crea autorizzazione personalizzata (predefinito N). |
Esempio
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Risposta — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 2426273,
"total": 16.2,
"listBaseOrderNumbers": [ "3388485_57471911" ],
"balance": 1776.88
},
"errors": []
}
Passo 6 — Recupera i proxy acquistati
Recupera i proxy acquistati. Filtra per l'orderId del passo precedente per vedere esattamente cosa è stato acquistato.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Risposta
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"date_start": "23.06.2024",
"date_end": "23.07.2024"
}
]
},
"errors": []
}
Riferimento API completo
Order actions — lista di riferimento, calcolo e ordine
Retrieve active proxy — elenca i tuoi proxy
Balance — saldo e sistemi di pagamento