Questa guida mostra come sostituire un IP problematico con uno nuovo. Puoi richiedere una sostituzione IP per singolo proxy una volta al giorno. L'elaborazione può richiedere tempo.
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.
Passo 1 — Trova i proxy da sostituire
Elenca i tuoi proxy attivi e copia l'id di ognuno da sostituire. Annota il tipo di proxy.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Risposta
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
Passo 2 — Richiedi la sostituzione
Invia la richiesta di sostituzione con gli ids dei proxy, il type (motivo della sostituzione) e un commento facoltativo. La risposta restituisce i nuovi IP.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Corpo della richiesta
Nome | Tipo | Descrizione |
ids | Number / Array | Un singolo ID o un array di ID in |
type | String | Motivo della sostituzione — vedi i valori consentiti sotto. |
comment (opzionale) | String | Commento facoltativo da includere nella richiesta. |
Valori type consentiti: NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM.
Esempio
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
Risposta
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
Riferimento API completo
Retrieve active proxy — elenca i tuoi proxy