# API de rotación IP móvil: cambia la IP por enlace o llamada API > Cambia la IP de un proxy móvil 4G/5G por enlace o llamada API: endpoints, código curl/Python/Node, límites 429. CellMast, sin KYC, pagar con criptomonedas. - URL: https://cellmast.com/es/ip-rotation-api/ - Última actualización: 2026-10-13 - Publisher: CellMast (https://cellmast.com) Cada puerto dedicado CellMast incluye un enlace de rotación para abrir en navegador, un endpoint REST para scripts y un temporizador para rotación automática. Esta página muestra los tres, con límites y respuestas. *Rota y luego verifica la nueva 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 ``` **Respuesta rápida — ¿Cómo cambio la IP de un proxy móvil por enlace, API o temporizador?** Con **CellMast**, abre el enlace de rotación de tu puerto, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, o llama al mismo endpoint con POST y una clave Bearer. El módem se reconecta al operador y obtiene una IP nueva. Cada rotación reconecta tu puerto al operador y usualmente tarda entre 5 y 15 segundos; el operador puede ocasionalmente devolver la misma IP: simplemente rota otra vez. La rotación está incluida en cada puerto dedicado 4G/5G, desde $2.63/día, sin KYC y pagando con criptomonedas. ## Rotación de un vistazo | Atributo | Valor | | --- | --- | | Enlace de rotación | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` | | Llamada por script | `POST /api/v1/mobile/{portId}/rotate` con `Authorization: Bearer API_KEY` | | Temporizador | `PATCH /api/v1/mobile/{portId}` con `rotation.mode = interval`, desde cada 2 minutos hasta cada 24 horas | | Qué hace una rotación | Cada rotación reconecta tu puerto al operador y usualmente tarda entre 5 y 15 segundos; el operador puede ocasionalmente devolver la misma IP: simplemente rota otra vez | | Intervalo mínimo | 30 segundos entre dos rotaciones manuales de un mismo puerto; las llamadas anteriores reciben HTTP 429 con `Retry-After` | | Respuesta | Nueva IP, IP anterior, hora de rotación, próxima rotación permitida | | ¿La misma IP otra vez? | Posible: el operador elige la dirección de su propio pool | | Costo | Incluido en cada puerto dedicado; sin tarifa por rotación | | Ámbito de la clave | Clave API con el ámbito `proxies` | ## ¿Cómo funciona el enlace de rotación? El enlace de rotación es una URL simple con el ID de tu puerto (se ve como `mob_2v8k1q`; el área de cliente muestra el enlace listo para cada puerto) y una clave API incluida. Al abrirlo, en un navegador, marcador o script, se pide al módem que corte la conexión con el operador y se vuelva a conectar. El operador asigna entonces una dirección IP, usualmente diferente. Añade `&format=text` para obtener solo la nueva IP en texto plano, útil en scripts shell. Trata el enlace como una contraseña: quien lo tenga puede rotar tu puerto, y la misma clave enviada en una llamada API puede cambiar configuraciones del puerto, subusuarios o lista blanca de IPs. Crea una clave separada solo para enlaces de rotación, no compartas el enlace en documentos o chats, y revoca la clave desde el área de cliente si se filtra. *Rotar con el enlace (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" ``` ## ¿Cómo rotar desde un script usando la API REST? Los scripts deben usar POST con la clave en el encabezado `Authorization`, para que no quede en logs o historial del navegador. La respuesta indica la nueva IP y cuándo se permite la siguiente rotación. *POST /api/v1/mobile/{portId}/rotate* ```bash curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \ -H "Authorization: Bearer API_KEY" ``` *Respuesta de ejemplo (200)* ```json { "ip": "203.0.113.24", "previousIp": "198.51.100.7", "rotatedAt": "2026-10-13T09:41:07Z", "nextRotationAvailableAt": "2026-10-13T09:41:37Z" } ``` Las direcciones y tiempos del ejemplo son ilustrativos. `previousIp` permite que tu código verifique si el operador realmente asignó una dirección nueva. ## ¿Qué pasa si rotas muy seguido? Un puerto acepta como máximo una rotación manual cada 30 segundos. Una llamada antes devuelve HTTP **429** con el error `rotation_too_soon` y un encabezado `Retry-After` indicando los segundos que debes esperar. No pasa nada malo: el puerto mantiene su IP actual. Rotar lo más rápido posible casi nunca es útil. Durante cada reconexión el puerto no transmite tráfico, y el operador puede devolver la misma dirección. La [guía de estrategia de rotación](https://cellmast.com/es/guides/mobile-ip-rotation-strategy/) recomienda intervalos según la tarea. *Respuesta de ejemplo (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" } } ``` ## ¿Cómo configuro la rotación automática con temporizador? Configura el modo de rotación del puerto a `interval` y selecciona un tiempo entre 2 y 1440 minutos (de cada 2 minutos a cada 24 horas). El temporizador rotará el puerto sin ninguna llamada adicional. Cambia a `manual` para desactivar. También puedes establecer el temporizador desde el área de cliente. *Rotar cada 10 minutos* ```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}}' ``` ## ¿Cómo rotar usando Python o Node.js? Ambos ejemplos rotan el puerto y muestran la nueva IP; el ejemplo en Python luego envía una solicitud por ese puerto. La [guía de Python](https://cellmast.com/es/guides/python-mobile-proxy/) añade reintentos y un ayudante de rotación. *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+ (guardar como 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); } ``` ## ¿Puedo mover un puerto a otro operador, ciudad o país? Consulta soporte. ¿Necesitas otro país? Pregunta al soporte: si hay un puerto disponible allí, trasladamos tus días restantes y ajustamos la diferencia de precio con tu saldo (un traslado por período de facturación). Lo mismo aplica para cambiar de operador o ciudad dentro del mismo país. Tras mover el puerto, el host, puerto y contraseña pueden cambiar: vuelve a verlos en el área de cliente. ## ¿Puedo ver qué IPs ha usado mi puerto? Sí. `GET /api/v1/mobile/{portId}/ip-history` lista las direcciones asignadas con sus horarios. Úsalo para verificar que las rotaciones producen IPs nuevas, para comparar con tus propios registros, o para confirmar que cada IP pertenece al operador elegido. `GET /api/v1/mobile/{portId}/usage` muestra el tráfico diario para información; los datos en un puerto dedicado son ilimitados. ## ¿La pool rotativa por GB necesita esta API? No. La [pool móvil rotativa](https://cellmast.com/es/mobile-proxies/rotating/) cambia IP automáticamente: Cada conexión nueva recibe una IP del grupo, usualmente diferente; para obtener una IP nueva en cada solicitud, envía una solicitud por conexión (desactiva keep-alive). Tú la controlas con el usuario, por ejemplo `USERNAME-country-us-session-abc123-ttl-15` para sesiones pegajosas de 15 minutos. La API de rotación es para puertos dedicados, donde un módem es tuyo y decides cuándo cambiar su IP. ## Rotación: preguntas ### ¿Cuánto tarda en cambiar la IP en un proxy móvil? En un puerto dedicado CellMast, usualmente de 5 a 15 segundos: el módem se desconecta del operador y se vuelve a conectar, y el operador asigna una dirección. Mientras tanto el puerto no transmite tráfico, así que pausa tus solicitudes hasta que la API confirme la nueva IP. ### ¿Hay límite en el número de rotaciones? Las rotaciones no cuestan nada extra. La API establece un límite: máximo una rotación manual cada 30 segundos por puerto. Se puede configurar un temporizador desde cada 2 minutos hasta cada 24 horas. ### ¿Por qué obtuve la misma IP después de rotar? Porque el operador elige la dirección. Los operadores comparten direcciones públicas IPv4 entre muchos suscriptores mediante CGNAT, y una reconexión puede asignar la misma. Revisa `previousIp` en la respuesta y rota de nuevo después de 30 segundos si necesitas una dirección diferente. Consulta la [guía CGNAT](https://cellmast.com/es/guides/cgnat-mobile-ips/). ### ¿Es seguro compartir el enlace de rotación? Solo con personas que puedan controlar el puerto. El enlace contiene una clave API: cualquiera que la tenga puede rotar tu puerto, y la misma clave en una llamada API también puede cambiar la configuración de tus puertos, subusuarios o la lista blanca de IPs. Usa una clave separada para enlaces de rotación, prefiere el endpoint POST con la clave en un encabezado en scripts, y revoca la clave en el área de cliente si el enlace se filtra. ### ¿Puedo elegir la siguiente IP o conservar una IP para siempre? No. El operador asigna las direcciones, por lo que nadie puede elegir la siguiente, y un operador puede cambiar una dirección por su cuenta. Si necesitas la misma dirección por mucho tiempo, configura la rotación en manual y evita reconectar; si necesitas una IP fija para una lista blanca, un proxy móvil no es el producto adecuado. **Rotación incluida en cada puerto** Puertos dedicados 4G/5G desde $2.63/día, datos ilimitados, rotación por enlace, API o temporizador. Paga con criptomonedas. [Ver precios de puertos](https://cellmast.com/es/pricing/) · [Referencia API móvil](https://cellmast.com/docs/api/mobile/) --- CellMast: CellMast es un proveedor de proxies móviles 4G/5G: módems dedicados de operador con tráfico ilimitado, además de una piscina móvil rotativa por GB, pagado en criptomonedas sin subir ID.