Azioni con i proxy

Gestire gli indirizzi IP all’interno degli ordini proxy: elencarli, ruotarli, estenderne la validità o annotarli.

Parametro comune. Ogni endpoint in questa pagina opera secondo un ordine specifico. Passare orderNumber — ottenerlo da GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list

Restituisce i proxy attivi raggruppati per tipo.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}

Restituisce i proxy attivi di un determinato tipo. Supporta gli stessi parametri di query di /proxy/list

Parametri del percorso

Nome

Valore

Obbligatorio

Descrizione

Tipo

ipv4, ipv6, mobile, isp, mix, mix_isp, oppure resident

Sì

Specifica il tipo di proxy da includere nell'elenco scaricato.

Autorizzazione

<Your_API_Key>

Sì

La tua chiave API personale (Come ottenere)

Parametri di query

Nome	Tipo	Obbligatorio	Descrizione
ultimo aggiornamento	Stringa	No	`Y`restituisce i proxy dall’ultimo ordine attivo quando `orderId` non è fornita.
orderId	Stringa	No	Restituisci un proxy a partire da uno specifico orderId o OrderPart.number
paese	Stringa	No	Nome del paese in Alpha3 (FRA o DEU re…)
fine	Stringa	No	`Y` restituisce solo `ENDED` proxy che hanno ancora `dateEnd` in futuro. In caso contrario, i proxy chiusi sono esclusi.

Esempio

Per recuperare proxy di tutti i tipi:

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

Per recuperare i proxy di un tipo specifico (ad es. IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

Risposta

Tutti i tipi di proxy

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

Un tipo di proxy

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

Tipo di proxy errato

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Si prega di notare che, se non viene specificato alcun tipo di proxy, verranno restituiti tutti i tipi disponibili per il proprio profilo.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}

Esportazione degli IP

Questo endpoint API ti consente di scaricare l'elenco dei tuoi proxy.

Parametri del percorso:

Nome	Valore	Obbligatorio	Descrizione
Tipo	`ipv4`, `ipv6`, `mobile`, `isp`, `mix`, `mix_isp`, oppure `resident`	Sì	Specifica il tipo di proxy da includere nell'elenco scaricato.
Autorizzazione	`<Your_API_Key>`	Sì	La tua chiave API personale (Come ottenere)

Parametri opzionali

Nome	Valore	Descrizione
ext	txt csv	Specifica il formato in cui verrà scaricato l'elenco dei proxy.
	%login%:%password%@%ip%:%port%	Formato personalizzato
proto	https socks5	Specifica il formato della porta proxy che preferisci per i proxy.
listId	Numero intero	ID elenco proxy (solo per residenti; se non impostato, verranno restituiti gli indirizzi IP da tutti i fogli)
package_key	Stringa	Elenco proxy package_key (solo per subresident)
paese	Stringa	Nome del paese in Alpha3 (FRA o USA o ...)
fine	Stringa	`Y` - Elenco dei proxy finali

Esempio

Per recuperare i proxy di un tipo specifico (ad es. IPv4):

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

Risposta

risposta: tipo di proxy errato

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Modifica

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace

Sostituire gli indirizzi IP

Ruotare un IP senza perdere lo slot dell’ordine. Viene conteggiato ai fini della quota mensile di sostituzioni.

Parametri del percorso

Nome	Valore	Obbligatorio	Descrizione
Autorizzazione	`<Your_API_Key>`	Sì	La tua chiave API personale (Come ottenere)

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Numero	Un singolo ID o un array di ID racchiuso tra '[ ]', separati da virgole
commento	Stringa	Commento facoltativo da includere nella richiesta
tipo	Stringa	Tipo di sostituzione

Esempio

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

Risposta

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

Tipi di sostituzione: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

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

Prolungare gli indirizzi IP

Prorogare la scadenza per gli IP selezionati. Fatturazione per IP al giorno.

Questo documento fornisce una guida dettagliata su come configurare il rinnovo automatico per i vostri indirizzi IP di vario tipo. Si prega di notare che gli indirizzi IP devono essere rinnovati tempestivamente per mantenere gli stessi indirizzi.

Calcola l'estensione

Questo endpoint ti aiuta a calcolare il costo. Gli sconti per volume e periodi di noleggio sono simili a quelli offerti dal nostro servizio.

Parametri del percorso

Nome

Valore

Obbligatorio

Descrizione

Autorizzazione

<Your_API_Key>

Sì

La tua chiave API personale (Come ottenere)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sì

Il tipo di proxy che si desidera estendere

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Numero	Un singolo ID o un array di ID racchiuso tra '[ ]', separati da virgole (come ottenerlo)
coupon	Stringa	Il commento che desideri aggiungere
periodId	Stringa	ID del periodo selezionato nella richiesta /reference/list/{type}

Esempio (ad es. ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Risposta

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}

Prolungare gli indirizzi IP

In questa sezione imparerai come creare un ordine di rinnovo.

Crea un ordine di rinnovo

Crea un ordine di estensione.

Parametri del percorso

Nome

Valore

Obbligatorio

Descrizione

Autorizzazione

<Your_API_Key>

Sì

La tua chiave API personale (Come ottenere)

Tipo

ipv4

ipv6

mobile

isp

mix

mix_isp

Sì

Il tipo di proxy che si desidera estendere

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Numero	Un singolo ID o un array di ID racchiuso tra parentesi quadre '[ ]', separati da virgole (come ottenerlo)
coupon	Stringa	Codice promozionale.
periodId	Stringa	ID del periodo selezionato nella richiesta /reference/list/{type}
paymentId	Stringa	ID del sistema di pagamento "69e799e7497b2c153b33faca" - equilibrio, "69e799e8497b2c153b33faed" - carta che hai aggiunto alla tua bacheca

Esempio (ad es. ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Risposta

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set

Aggiungi commenti

Allegare una nota in formato libero (max 256 caratteri) per aiutare a identificare un IP nell’interfaccia utente o nei file esportati.

Parametri del percorso

Nome	Valore	Obbligatorio	Descrizione
Autorizzazione	`<Your_API_Key>`	Sì	La tua chiave API personale (Come ottenere)

Corpo della richiesta

Nome	Tipo	Descrizione
ids	Numero	Un singolo ID o un array di ID racchiuso tra '[ ]', separati da virgole (come ottenerlo)
commento	Stringa	Il commento che desideri aggiungere

Esempio

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

Risposta

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

Comune a tutti gli endpoint proxy

URL di base

https://proxy-seller.com/personal/api/v2/{YourApiKey}/

Autenticazione
Chiave API nel percorso dell'URL.
Modello di errore
Gli errori di business restituiscono un codice HTTP 200 con errors[] popolato.

Dopo aver gestito i tuoi indirizzi IP

Authorizationissue per-order credentialsOpen Order actionsbuy more proxies when you need additional IPsOpen Balancecheck funds before bulk prolongationOpen

Parametri del percorso

Parametri di query

Esempio

Risposta

Parametri del percorso:

Parametri opzionali

Esempio

Risposta

Modifica

Parametri del percorso

Corpo della richiesta

Esempio

Risposta

Calcola l'estensione

Parametri del percorso

Corpo della richiesta

Esempio (ad es. ipv4)

Risposta

Crea un ordine di rinnovo

Parametri del percorso

Corpo della richiesta

Esempio (ad es. ipv4)

Risposta

Parametri del percorso

Esempio

Risposta

Comune a tutti gli endpoint proxy

URL di base

Autenticazione

Modello di errore

Dopo aver gestito i tuoi indirizzi IP

On this page