Questa guida mostra come rinnovare (estendere) i proxy che già possiedi tramite l'API, mantenendo gli stessi indirizzi IP. Rinnova in tempo: una volta scaduto il proxy, l'IP potrebbe andare perso.

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.

⚠️ L'ultimo passaggio addebita il tuo saldo. Verifica sempre prima il costo nel passaggio di calcolo.

Il flusso in breve

Trova i proxy da rinnovare e copia i loro ID.
Scegli un metodo di pagamento (o usa il saldo).
Calcola il costo del rinnovo.
Esegui il rinnovo.

Passo 1 — Trova i proxy da rinnovare

Elenca i tuoi proxy attivi e copia l'id di ognuno che vuoi estendere. Solo i proxy con can_prolong: true possono essere rinnovati. Annota il tipo di proxy (ipv4, ipv6, mobile, isp, mix, mix_isp): ti servirà nei passaggi successivi.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Parametri del percorso

Nome	Valore	Descrizione
type (opzionale)	`ipv4`	Il tipo di proxy da recuperare. Se omesso, vengono restituiti tutti i tipi.

Parametri query opzionali

Nome	Tipo	Descrizione
latest	String	Y/N — restituisce solo i proxy dell'ultimo ordine.
orderId	String	Restituisce i proxy di un orderId o baseOrderNumber specifico.
country	String	Codice paese alpha-3 (es. FRA, USA).
ends	String	Y — solo i proxy in scadenza.

Esempio

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

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",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Copia l'id di ogni proxy da rinnovare. Assicurati che can_prolong sia true.

Passo 2 — Scegli un metodo di pagamento

Elenca i sistemi di pagamento disponibili e copia l'id desiderato come paymentId. Per pagare con il saldo del tuo account, puoi saltare questo passaggio e usare 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 3 — Calcola il costo del rinnovo

Prima di pagare, calcola il costo. Gli sconti per volume e periodo di noleggio si applicano come sul sito. Questo passaggio non addebita nulla.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Number / Array	Un singolo ID o un array di ID in `[ ]`, separati da virgole — dal passo 1.
periodId	String	ID del periodo di rinnovo. Ottieni i periodi disponibili dall'endpoint `/reference/list/{type}`.
paymentId	String	ID del sistema di pagamento. `1` = saldo, `43` = carta aggiunta al tuo account.
coupon (opzionale)	String	Un codice coupon, se ne hai uno.

Esempio

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4

Risposta — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

Se il saldo è troppo basso, riceverai un avviso Insufficient funds:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Passo 4 — Esegui il rinnovo (addebita il tuo saldo)

Quando il costo calcolato è corretto, crea l'ordine di rinnovo. Questo passaggio addebita il tuo saldo. Usa gli stessi parametri del passo 3.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Number / Array	Un singolo ID o un array di ID in `[ ]`, separati da virgole.
periodId	String	ID del periodo di rinnovo (da `/reference/list/{type}`).
paymentId	String	ID del sistema di pagamento. `1` = saldo.
coupon (opzionale)	String	Un codice coupon, se ne hai uno.

Esempio

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4

Risposta — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

I proxy mantengono gli stessi IP con una nuova data di scadenza.

Riferimento API completo

Extend proxies — calcolare ed eseguire il rinnovo
Retrieve active proxy — elenca i tuoi proxy
Balance — saldo e sistemi di pagamento

Estendere (rinnovare) i proxy

Il flusso in breve

Passo 1 — Trova i proxy da rinnovare

Passo 2 — Scegli un metodo di pagamento

Passo 3 — Calcola il costo del rinnovo

Passo 4 — Esegui il rinnovo (addebita il tuo saldo)

Riferimento API completo