API de rotación IP móvil: cambia la IP por enlace o llamada API

¿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.

# 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.

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"
}

¿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 recomienda intervalos según la tarea.

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.

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 añade reintentos y un ayudante de rotación.

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);
}

¿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 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.