API de rotação de IP de proxy móvel: troque o IP por link ou chamada API

Como funciona o link de rotação?

O link de rotação é uma URL simples com o ID da sua porta (parece com mob_2v8k1q; a área do cliente mostra o link pronto de cada porta) e uma chave API nele. Abrir esse link, no navegador, favorito ou script, pede ao modem para desconectar do carrier e conectar novamente. O carrier então atribui um endereço IP, geralmente diferente.

Adicione &format=text para obter apenas o novo IP em texto puro, útil em scripts shell. Trate o link como uma senha: quem tem ele pode rotacionar sua porta, e a mesma chave em chamadas API pode alterar configurações, subusuários ou lista de IPs permitidos. Crie uma chave separada só para links de rotação, mantenha o link fora de documentos compartilhados e visualização de chats, e revogue a chave na área do cliente se vazar.

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

Como rotacionar de um script com a API REST?

Scripts devem usar POST com a chave no cabeçalho Authorization, para que a chave não apareça em logs do servidor ou histórico do navegador. A resposta informa o novo IP e quando a próxima rotação é permitida.

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

O que acontece se eu rotacionar com muita frequência?

Uma porta aceita no máximo uma rotação manual a cada 30 segundos. Chamar antes disso retorna HTTP 429 com erro rotation_too_soon e um cabeçalho Retry-After que informa os segundos a esperar. Nada quebra: a porta mantém o IP atual.

Rotacionar o mais rápido possível raramente é útil. Na reconexão, a porta fica sem tráfego, e o carrier pode devolver o mesmo endereço. O guia de estratégia de rotação sugere intervalos para cada tarefa.

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

Como configurar rotação automática com temporizador?

Defina o modo da porta para interval e escolha minutos entre 2 e 1.440 (a cada 2 minutos até a cada 24 horas). O temporizador rotaciona a porta sem sua ação. Volte para manual para parar. Também é possível ajustar isso na área do 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}}'

Como rotacionar em Python ou Node.js?

Ambos exemplos rotacionam a porta e exibem o novo IP; o exemplo em Python depois envia requisição via porta. O guia Python adiciona tentativas e helper para rotação.

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 mover uma porta para outro carrier, cidade ou país?

Peça no suporte. Precisa de outro país? Pergunte ao suporte: se uma porta estiver disponível lá, transferimos seus dias restantes para ela e ajustamos a diferença de preço pelo seu saldo (uma transferência por período de cobrança). O mesmo vale para outro carrier ou cidade no mesmo país. Após a mudança, host, porta e senha podem alterar: verifique novamente na área do cliente.

Posso ver quais IPs minha porta usou?

Sim. GET /api/v1/mobile/{portId}/ip-history lista os endereços atribuídos à porta com horários. Use para conferir se rotações geram IPs novos, conferir seus próprios logs, ou confirmar que cada IP pertence ao carrier escolhido. GET /api/v1/mobile/{portId}/usage mostra tráfego diário para informação; dados em porta dedicada são ilimitados.

Pool rotativo por GB precisa dessa API?

Não. O pool móvel rotativo troca IP sozinho: Cada nova conexão recebe um IP da pool, geralmente diferente; para obter um IP novo a cada requisição, envie uma requisição por conexão (desative keep-alive).. Você controla com nome de usuário, p.ex. USERNAME-country-us-session-abc123-ttl-15 para sessão fixa de 15 minutos. A API de rotação é para portas dedicadas, onde um modem é seu e você decide quando muda IP.