# API rotacji IP mobilnego proxy: zmiana IP przez link lub wywołanie API

> Zmień IP mobilnego proxy 4G/5G przez link lub wywołanie API: endpointy, kod curl/Python/Node, limity 429. CellMast, bez KYC, płatność w crypto.

- URL: https://cellmast.com/pl/ip-rotation-api/
- Ostatnia aktualizacja: 2026-10-13
- Publisher: CellMast (https://cellmast.com)

Każdy dedykowany port CellMast ma link do rotacji, który możesz otworzyć w przeglądarce, REST endpoint do skryptów oraz timer do automatycznej rotacji. Ta strona pokazuje wszystkie trzy z limitami i odpowiedziami.

*Rotuj, a potem sprawdź nowe 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
```

**Szybka odpowiedź — Jak zmienić IP mobilnego proxy przez link, API lub timer?**

Z **CellMast** otwórz link rotacji portu, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, albo wywołaj ten sam endpoint metodą POST z kluczem Bearer. Modem przełącza się do operatora i dostaje nowe IP. Każda rotacja ponownie łączy port z operatorem i zwykle trwa 5–15 sekund; operator czasem może przydzielić to samo IP: po prostu dokonaj rotacji ponownie.. Rotacja jest wliczona w każdy dedykowany port 4G/5G, od 2,63 USD/dzień, bez KYC i płatności w crypto.

## Rotacja w skrócie

| Atrybut | Wartość |
| --- | --- |
| Link do rotacji | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` |
| Wywołanie skryptu | `POST /api/v1/mobile/{portId}/rotate` z `Authorization: Bearer API_KEY` |
| Timer | `PATCH /api/v1/mobile/{portId}` z `rotation.mode = interval`, od co 2 minuty do co 24 godziny |
| Co robi rotacja | Każda rotacja ponownie łączy port z operatorem i zwykle trwa 5–15 sekund; operator czasem może przydzielić to samo IP: po prostu dokonaj rotacji ponownie. |
| Minimalna przerwa | 30 sekund między dwoma ręcznymi rotacjami jednego portu; wcześniejsze wywołania otrzymują HTTP 429 z `Retry-After` |
| Odpowiedź | Nowe IP, poprzednie IP, czas rotacji, następny dozwolony obrót |
| Ten sam adres IP? | Możliwe: operator wybiera adres ze swojego puli |
| Koszt | Wliczony w cenę każdego dedykowanego portu; brak opłaty za każdą rotację |
| Zakres klucza | Klucz API z zakresem `proxies` |

## Jak działa link do rotacji?

Link do rotacji to zwykły URL z ID portu (wygląda jak `mob_2v8k1q`; w panelu klienta każdy port ma gotowy link) oraz kluczem API. Otwierając go w przeglądarce, zakładce lub skrypcie, modem zerwie połączenie z operatorem i połączy się ponownie. Operator zazwyczaj przydziela inne IP.

Dodaj `&format=text`, aby otrzymać tylko nowe IP w czystym tekście – przydatne w skryptach powłoki. Traktuj link jak hasło: każdy, kto go ma, może rotować Twój port, a ten sam klucz wysyłany w wywołaniu API może zmieniać ustawienia portów, sub-użytkowników czy listę dozwolonych IP. Stwórz osobny klucz tylko dla linków do rotacji, nie udostępniaj linku w dokumentach ani czatach i wycofaj klucz w panelu klienta, jeśli wycieknie.

*Rotuj za pomocą linku (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"
```

## Jak rotować ze skryptu przez REST API?

Skrypty powinny wysyłać POST z kluczem w nagłówku `Authorization`, aby klucz nie trafił do logów serwera ani historii przeglądarki. Odpowiedź zwraca nowe IP i czas, kiedy dozwolona jest następna rotacja.

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

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

*Przykładowa odpowiedź (200)*

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

Adresy i czasy w przykładzie są orientacyjne. `previousIp` pozwala sprawdzić, czy operator rzeczywiście przypisał nowe IP.

## Co się stanie, jeśli będę obracać zbyt często?

Port akceptuje maksymalnie jedną ręczną rotację co 30 sekund. Wywołanie przed upływem tego czasu zwraca HTTP **429** z błędem `rotation_too_soon` oraz nagłówkiem `Retry-After` informującym, ile sekund trzeba czekać. Nic się nie psuje: port zachowuje aktualne IP.

Rotacja jak najszybciej rzadko jest przydatna. Podczas każdorazowego ponownego łączenia port nie przesyła ruchu, a operator może przydzielić ten sam adres. [Przewodnik po strategii rotacji](https://cellmast.com/pl/guides/mobile-ip-rotation-strategy/) sugeruje odstępy w zależności od zadania.

*Przykładowa odpowiedź (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"
  }
}
```

## Jak ustawić automatyczną rotację na timerze?

Ustaw tryb rotacji portu na `interval` i wybierz liczbę minut od 2 do 1,440 (co 2 minuty do co 24 godziny). Timer wtedy obraca port bez Twojego wywołania. Przełącz na `manual`, aby zatrzymać. Możesz też ustawić timer w panelu klienta.

*Rotuj co 10 minut*

```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}}'
```

## Jak rotować w Pythonie lub Node.js?

Oba przykłady obracają port i wyświetlają nowe IP; przykład Python następnie wysyła zapytanie przez port. [Poradnik Python](https://cellmast.com/pl/guides/python-mobile-proxy/) dodaje próby ponowne i pomocnika rotacji.

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

## Czy mogę przenieść port do innego operatora, miasta lub kraju?

Skontaktuj się z supportem. Potrzebujesz innego kraju? Zapytaj support: jeśli port jest tam dostępny, przeniesiemy twoje pozostałe dni na ten port i rozliczymy różnicę w cenie z twoim saldem (jedna zmiana na okres rozliczeniowy). To samo dotyczy innego operatora lub miasta w tym samym kraju. Po przeniesieniu host, port i hasło mogą się zmienić – sprawdź je ponownie w panelu klienta.

## Czy mogę zobaczyć, jakich IP używał mój port?

Tak. `GET /api/v1/mobile/{portId}/ip-history` pokazuje adresy przydzielone portowi razem z czasem. Użyj tego, by sprawdzić, czy rotacje dają nowe adresy, porównać z własnymi logami lub potwierdzić, że każdy adres należy do wybranego operatora. `GET /api/v1/mobile/{portId}/usage` pokazuje dzienny ruch informacyjny; dane na dedykowanym porcie są nieograniczone.

## Czy pulę rotating per-GB trzeba obsługiwać przez API?

Nie. [rotująca pula mobilna](https://cellmast.com/pl/mobile-proxies/rotating/) zmienia IP automatycznie: Każde nowe połączenie otrzymuje IP z puli, zwykle inne; aby uzyskać nowe IP przy każdym żądaniu, wyślij jedno żądanie na połączenie (wyłącz keep-alive). Zarządzasz nią przez nazwę użytkownika, np. `USERNAME-country-us-session-abc123-ttl-15` dla 15-minutowej sesji sticky. API rotacji jest dla dedykowanych portów, gdzie modem jest Twój i decydujesz, kiedy zmienia się jego IP.

## Rotacja: pytania

### Jak długo trwa zmiana IP na mobilnym proxy?

Na dedykowanym porcie mobilnym CellMast zwykle 5–15 sekund: modem rozłącza się z operatorem i łączy ponownie, a operator przydziela adres. W tym czasie port nie przesyła ruchu, więc wstrzymaj żądania do momentu zwrotu nowego IP przez API.

### Czy istnieje limit liczby rotacji?

Rotacje nie kosztują nic dodatkowo. API ustawia jeden limit: maksymalnie jedna ręczna rotacja na port co 30 sekund. Timer można ustawić od 2 minut do 24 godzin.

### Dlaczego po rotacji dostałem ten sam IP?

Ponieważ adres wybiera operator. Operatorzy udostępniają publiczne adresy IPv4 wielu abonentom przez CGNAT, więc ponowne połączenie może trafić na ten sam adres. Sprawdź `previousIp` w odpowiedzi i zrotuj ponownie po 30 sekundach, jeśli potrzebujesz innego adresu. Zobacz [poradnik CGNAT](https://cellmast.com/pl/guides/cgnat-mobile-ips/).

### Czy link do rotacji można bezpiecznie udostępniać?

Tylko osobom, które mogą kontrolować port. Link zawiera klucz API: każdy, kto go posiada, może rotować Twój port, a ten sam klucz w wywołaniu API może też zmieniać ustawienia portów, sub-użytkowników lub listę dozwolonych IP. Używaj osobnego klucza do linków rotacji, preferuj endpoint POST z kluczem w nagłówku w skryptach i cofaj klucz w panelu klienta, jeśli link wycieknie.

### Czy mogę wybrać kolejny IP lub zachować IP na zawsze?

Nie. Operator przydziela adresy, więc nikt nie może wybrać kolejnego, a operator może sam zmienić adres. Jeśli potrzebujesz tego samego adresu przez długi czas, ustaw rotację na ręczną i unikaj rozłączeń; jeśli potrzebujesz stałego IP do listy dozwolonych, mobilne proxy nie jest odpowiednim produktem.

**Rotacja dostępna na każdym porcie** Dedykowane porty 4G/5G od 2,63 USD/dzień, nielimitowane dane, rotacja przez link, API lub timer. Płać w kryptowalutach. [Zobacz ceny portów](https://cellmast.com/pl/pricing/) · [Mobilne API - dokumentacja](https://cellmast.com/docs/api/mobile/)

---

CellMast: CellMast to dostawca mobilnych proxy 4G/5G: dedykowane modemy operatorskie z nielimitowanym transferem oraz rotująca pula mobilnych proxy 4G płatna w kryptowalutach bez konieczności przesyłania dokumentów.