API rotazione IP proxy mobile: cambia IP via link o chiamata API

Come funziona il link di rotazione?

Il link di rotazione è un URL semplice con l'ID della tua porta (sembra mob_2v8k1q; l’area clienti mostra il link pronto per ogni porta) e una chiave API incorporata. Aprirlo, in un browser, come segnalibro o in uno script, chiede al modem di disconnettersi dall’operatore e ricollegarsi. L’operatore assegna quindi un indirizzo IP, solitamente diverso.

Aggiungi &format=text per ricevere solo il nuovo IP come testo semplice, utile negli script shell. Tratta il link come una password: chiunque lo abbia può ruotare la tua porta, e la stessa chiave inviata in una chiamata API può anche modificare impostazioni delle porte, sotto-utenti o liste IP consentite. Crea una chiave separata solo per i link di rotazione, non condividere il link in documenti o anteprime di chat e revoca la chiave nell’area clienti se vengono compromessi.

# Replace {port} with your port ID (e.g. mob_2v8k1q, not 7777) and API_KEY with your key
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY"

# Plain-text answer: just the new IP
curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text"

Come ruotare da uno script con REST API?

Gli script devono usare POST con la chiave nell’intestazione Authorization, per evitare che la chiave finisca nei log del server o nella cronologia del browser. La risposta indica il nuovo IP e quando è consentita la prossima rotazione.

curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \
  -H "Authorization: Bearer API_KEY"

{
  "ip": "203.0.113.24",
  "previousIp": "198.51.100.7",
  "rotatedAt": "2026-10-13T09:41:07Z",
  "nextRotationAvailableAt": "2026-10-13T09:41:37Z"
}

Cosa succede se ruoto troppo spesso?

Una porta accetta al massimo una rotazione manuale ogni 30 secondi. Una chiamata anticipata restituisce HTTP 429 con errore rotation_too_soon e un’intestazione Retry-After che indica i secondi di attesa. Nulla si blocca: la porta mantiene il suo IP attuale.

Ruotare il più velocemente possibile è raramente utile. Durante ogni riconnessione la porta non trasmette traffico, e l’operatore può restituire lo stesso indirizzo. La guida alla strategia di rotazione suggerisce intervalli in base al compito.

HTTP/1.1 429 Too Many Requests
Retry-After: 22
Content-Type: application/json

{
  "error": {
    "code": "rotation_too_soon",
    "message": "Next rotation available in 22 seconds",
    "details": { "retryAfter": 22 },
    "requestId": "req_2b7c11"
  }
}

Come imposto la rotazione automatica con un timer?

Imposta la modalità di rotazione della porta su interval e scegli un numero di minuti da 2 a 1.440 (da ogni 2 minuti a ogni 24 ore). Il timer ruota la porta senza alcuna chiamata da parte tua. Torna a manual per fermarla. Puoi anche impostare il timer dall’area clienti.

curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "interval", "intervalMinutes": 10}}'

# back to manual rotation
curl -X PATCH "https://cellmast.com/api/v1/mobile/PORT_ID" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rotation": {"mode": "manual", "intervalMinutes": null}}'

Come ruoto in Python o Node.js?

Entrambi gli esempi ruotano la porta e stampano il nuovo IP; l’esempio Python poi invia una richiesta tramite la porta. La guida Python aggiunge ritentativi e un aiuto per la rotazione.

import requests

API = "https://cellmast.com/api/v1"
KEY = "API_KEY"
PORT_ID = "PORT_ID"
PROXY = "http://USERNAME:[email protected]:7777"

r = requests.post(f"{API}/mobile/{PORT_ID}/rotate",
                  headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
if r.status_code == 429:
    print("too soon, retry after", r.headers.get("Retry-After"), "s")
else:
    r.raise_for_status()
    print("new IP:", r.json()["ip"])

print(requests.get("https://api.ipify.org",
                   proxies={"http": PROXY, "https": PROXY}, timeout=30).text)

// save as rotate.mjs (ES module), then: node rotate.mjs
const API = "https://cellmast.com/api/v1";
const res = await fetch(`${API}/mobile/PORT_ID/rotate`, {
  method: "POST",
  headers: { Authorization: "Bearer API_KEY" },
  signal: AbortSignal.timeout(60000),
});
if (res.status === 429) {
  console.log("retry after", res.headers.get("retry-after"), "s");
} else if (!res.ok) {
  throw new Error(`HTTP ${res.status}`);
} else {
  const { ip, previousIp } = await res.json();
  console.log(previousIp, "->", ip);
}

Posso spostare una porta su un altro operatore, città o paese?

Chiedi il supporto. Hai bisogno di un altro paese? Chiedi al supporto: se un proxy residenziale è disponibile lì, trasferiamo i tuoi giorni rimanenti su di esso e sistemiamo la differenza di prezzo tramite il tuo saldo (un trasferimento per periodo di fatturazione). Lo stesso vale per un altro operatore o città nello stesso paese. Dopo uno spostamento, host, porta e password possono cambiare: rileggili in area clienti.

Posso vedere quali IP ha usato la mia porta?

Sì. GET /api/v1/mobile/{portId}/ip-history elenca gli indirizzi assegnati alla porta con i relativi orari. Usalo per verificare che le rotazioni producano nuovi indirizzi, per confrontare i tuoi log o per confermare che ogni indirizzo appartenga all’operatore scelto. GET /api/v1/mobile/{portId}/usage mostra il traffico giornaliero per informazioni; i dati su una porta dedicata sono illimitati.

Il pool rotante per GB necessita di questa API?

No. Il pool mobile rotante cambia IP da solo: Ogni nuova connessione prende un IP dal pool, di solito diverso; per ottenere un IP nuovo a ogni richiesta, invia una richiesta per connessione (disattiva keep-alive). Lo controlli con lo username, per esempio USERNAME-country-us-session-abc123-ttl-15 per una sessione sticky di 15 minuti. L’API di rotazione è per porte dedicate, dove un modem è tuo e decidi tu quando cambiare IP.