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

> Troque o IP do proxy móvel 4G/5G por link ou chamada API: endpoints, código curl/Python/Node, limites 429. CellMast, sem KYC, pago com cripto.

- URL: https://cellmast.com/pt/ip-rotation-api/
- Última atualização: 2026-10-13
- Publisher: CellMast (https://cellmast.com)

Cada porta dedicada CellMast vem com um link de rotação que você pode abrir no navegador, um endpoint REST para scripts e um timer para rotação automática. Esta página mostra os três, com limites e respostas.

*Roteie, depois confira o novo 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
```

**Resposta rápida — Como troco o IP de um proxy móvel por link, API ou timer?**

Com **CellMast**, abra o link de rotação da sua porta, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, ou chame o mesmo endpoint com POST e uma chave Bearer. O modem reconecta à operadora e obtém um novo IP. Cada rotação reconecta sua porta à operadora e geralmente leva de 5 a 15 segundos; a operadora pode ocasionalmente devolver o mesmo IP: basta rotacionar de novo.. A rotação está incluída em todas as portas dedicadas 4G/5G, a partir de $2,63/dia, sem KYC e pagamento com cripto.

## Rotação em resumo

| Atributo | Valor |
| --- | --- |
| Link de rotação | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` |
| Chamada de script | `POST /api/v1/mobile/{portId}/rotate` com `Authorization: Bearer API_KEY` |
| Temporizador | `PATCH /api/v1/mobile/{portId}` com `rotation.mode = interval`, a partir de a cada 2 minutos até a cada 24 horas |
| O que uma rotação faz | Cada rotação reconecta sua porta à operadora e geralmente leva de 5 a 15 segundos; a operadora pode ocasionalmente devolver o mesmo IP: basta rotacionar de novo. |
| Intervalo mínimo | 30 segundos entre duas rotações manuais de uma mesma porta; chamadas anteriores recebem HTTP 429 com `Retry-After` |
| Resposta | Novo IP, IP anterior, tempo da rotação, próxima rotação permitida |
| O mesmo IP volta? | Possível: o carrier escolhe o endereço do seu pool |
| Custo | Incluído em cada porta dedicada; sem taxa por rotação |
| Escopo da chave | Chave API com escopo `proxies` |

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

*Rotacionar com o 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"
```

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

*POST /api/v1/mobile/{portId}/rotate*

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

*Exemplo de resposta (200)*

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

Os endereços e horários do exemplo são ilustrativos. `previousIp` permite que seu código confira se o carrier realmente deu um novo endereço.

## 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](https://cellmast.com/pt/guides/mobile-ip-rotation-strategy/) sugere intervalos para cada tarefa.

*Exemplo de resposta (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"
  }
}
```

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

*Rotacionar a 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}}'
```

## 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](https://cellmast.com/pt/guides/python-mobile-proxy/) adiciona tentativas e helper para rotação.

*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+ (salve 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);
}
```

## 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](https://cellmast.com/pt/mobile-proxies/rotating/) 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.

## Rotações: perguntas

### Quanto tempo demora uma troca de IP em proxy móvel?

Em uma porta dedicada CellMast, normalmente 5–15 segundos: o modem desconecta do carrier e reconecta, e o carrier atribui um IP. Nesse tempo a porta não transporta tráfego, então pause suas requisições até a API retornar o novo IP.

### Existe limite para número de rotações?

Rotações não têm custo extra. A API define um limite: no máximo uma rotação manual a cada 30 segundos por porta. Um timer pode ser definido entre 2 minutos e 24 horas.

### Por que recebi o mesmo IP após rotacionar?

Porque o carrier escolhe o endereço. Os carriers compartilham endereços públicos IPv4 entre vários assinantes via CGNAT, e uma reconexão pode retornar o mesmo IP. Verifique `previousIp` na resposta e rotacione novamente após 30 segundos se precisar de um endereço diferente. Veja o [guia CGNAT](https://cellmast.com/pt/guides/cgnat-mobile-ips/).

### O link de rotação é seguro para compartilhar?

Apenas com pessoas que podem controlar a porta. O link contém uma chave API: quem a tiver pode rotacionar sua porta, e a mesma chave em uma chamada API também pode alterar as configurações das portas, subusuários ou lista de IPs permitidos. Use uma chave separada para links de rotação, prefira o endpoint POST com a chave no header em scripts, e revogue a chave na área do cliente se o link vazar.

### Posso escolher o próximo IP ou manter um IP para sempre?

Não. O carrier atribui os endereços, então ninguém pode escolher o próximo, e um carrier pode trocar o endereço por conta própria. Se precisar do mesmo IP por muito tempo, defina rotação manual e evite reconexões; se precisar de IP fixo para uma lista de permissão, um proxy móvel 4G não é o produto certo.

**Rotação incluída em cada porta** Portas dedicadas 4G/5G a partir de $2,63/dia, dados ilimitados, rotação por link, API ou timer. Pague com cripto. [Veja preços das portas](https://cellmast.com/pt/pricing/) · [Referência API móvel](https://cellmast.com/docs/api/mobile/)

---

CellMast: CellMast é um provedor de proxies móveis 4G/5G: modems dedicados das operadoras com tráfego ilimitado, mais uma pool móvel rotativa por GB, pago em cripto sem upload de documentos.