# API rotazione IP proxy mobile: cambia IP via link o chiamata API > Cambia IP di un proxy mobile 4G/5G via link o chiamata API: endpoint, codice curl/Python/Node, limiti 429. CellMast, senza KYC, crypto. - URL: https://cellmast.com/it/ip-rotation-api/ - Ultimo aggiornamento: 2026-10-13 - Publisher: CellMast (https://cellmast.com) Ogni porta dedicata CellMast include un link di rotazione apribile in browser, un endpoint REST per script e un timer per rotazione automatica. Questa pagina mostra tutti e tre, con limiti e risposte. *Ruota e controlla il nuovo IP* ``` # 1. change the IP of your port $ curl "https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY&format=text" # 2. send a request through the port $ curl -x http://USERNAME:PASSWORD@gw.cellmast.com:7777 https://api.ipify.org ``` **Risposta rapida — Come cambio l’IP di un proxy mobile via link, API o timer?** Con **CellMast**, apri il link di rotazione della porta, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, o chiama lo stesso endpoint con POST e chiave Bearer. Il modem si ricollega al carrier e ottiene un nuovo IP. Ogni rotazione ricollega la tua porta al carrier e di solito impiega 5–15 secondi; il carrier può occasionalmente restituire lo stesso IP: basta ruotare di nuovo. La rotazione è inclusa in ogni porta dedicata 4G/5G, da $2,63/giorno, senza KYC e con pagamento in crypto. ## Rotazione in breve | Attributo | Valore | | --- | --- | | Link di rotazione | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` | | Chiamata script | `POST /api/v1/mobile/{portId}/rotate` con `Authorization: Bearer API_KEY` | | Timer | `PATCH /api/v1/mobile/{portId}` con `rotation.mode = interval`, da ogni 2 minuti a ogni 24 ore | | Cosa fa una rotazione | Ogni rotazione ricollega la tua porta al carrier e di solito impiega 5–15 secondi; il carrier può occasionalmente restituire lo stesso IP: basta ruotare di nuovo | | Intervallo minimo | 30 secondi tra due rotazioni manuali di una porta; le chiamate anticipate ricevono HTTP 429 con `Retry-After` | | Risposta | Nuovo IP, IP precedente, tempo di rotazione, prossima rotazione consentita | | Stesso IP di prima? | Possibile: l'operatore sceglie l'indirizzo dal proprio pool | | Costo | Incluso in ogni porta dedicata; nessuna tariffa per rotazione | | Ambito della chiave | Chiave API con ambito `proxies` | ## 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. *Ruota con il link (curl)* ```bash # 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. *POST /api/v1/mobile/{portId}/rotate* ```bash curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \ -H "Authorization: Bearer API_KEY" ``` *Esempio di risposta (200)* ```json { "ip": "203.0.113.24", "previousIp": "198.51.100.7", "rotatedAt": "2026-10-13T09:41:07Z", "nextRotationAvailableAt": "2026-10-13T09:41:37Z" } ``` Gli indirizzi e i tempi nell’esempio sono illustrativi. `previousIp` consente al tuo codice di verificare se l’operatore ha realmente fornito un nuovo indirizzo. ## 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](https://cellmast.com/it/guides/mobile-ip-rotation-strategy/) suggerisce intervalli in base al compito. *Esempio di risposta (429)* ```http 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. *Ruota ogni 10 minuti* ```bash 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](https://cellmast.com/it/guides/python-mobile-proxy/) aggiunge ritentativi e un aiuto per la rotazione. *Python (requests)* ```python import requests API = "https://cellmast.com/api/v1" KEY = "API_KEY" PORT_ID = "PORT_ID" PROXY = "http://USERNAME:PASSWORD@gw.cellmast.com: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) ``` *Node.js 18+ (salva come rotate.mjs)* ```javascript // 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](https://cellmast.com/it/mobile-proxies/rotating/) 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. ## Rotazione: domande ### Quanto tempo ci mette a cambiare IP un proxy mobile? Su una porta dedicata CellMast, solitamente 5–15 secondi: il modem si disconnette dall’operatore e si riattacca, e l’operatore assegna un indirizzo. Durante quel tempo la porta non trasmette traffico, quindi metti in pausa le richieste finché l’API non restituisce il nuovo IP. ### C’è un limite al numero di rotazioni? Le rotazioni non hanno costi aggiuntivi. L'API impone un solo limite: al massimo una rotazione manuale ogni 30 secondi per porta. È possibile impostare un timer da ogni 2 minuti a ogni 24 ore. ### Perché ho ricevuto lo stesso IP dopo la rotazione? Perché è il carrier a scegliere l'indirizzo. I carrier condividono indirizzi IPv4 pubblici tra molti abbonati tramite CGNAT, e una nuova connessione può assegnare lo stesso IP. Controlla `previousIp` nella risposta e ruota di nuovo dopo 30 secondi se ti serve un IP diverso. Vedi la [guida CGNAT](https://cellmast.com/it/guides/cgnat-mobile-ips/). ### Il link per la rotazione è sicuro da condividere? Solo con persone che possono controllare la porta. Il link contiene una chiave API: chiunque la possieda può ruotare la tua porta, e la stessa chiave in una chiamata API può anche modificare le impostazioni delle porte, sub-utenti o lista consentiti IP. Usa una chiave separata per i link di rotazione, preferisci l'endpoint POST con la chiave nell'intestazione negli script, e revoca la chiave nell'area clienti se il link viene compromesso. ### Posso scegliere l'IP successivo o mantenere un IP per sempre? No. Il carrier assegna gli indirizzi, quindi nessuno può scegliere il prossimo IP, e il carrier può cambiare un indirizzo in autonomia. Se ti serve lo stesso IP a lungo, imposta la rotazione manuale ed evita la riconnessione; se ti serve un IP fisso per una lista consentiti, un proxy mobile 4G non è il prodotto giusto. **Rotazione inclusa su ogni porta** Porte dedicate 4G/5G da $2,63/giorno, dati illimitati, rotazione tramite link, API o timer. Pagamento in crypto. [Vedi prezzi porte](https://cellmast.com/it/pricing/) · [Riferimento API mobile](https://cellmast.com/docs/api/mobile/) --- CellMast: CellMast è un fornitore di proxy mobili 4G/5G: modem carrier dedicati con traffico illimitato, più un pool mobile rotante a consumo per GB, pagabile in crypto senza caricamento di documenti.