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

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.

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

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

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 sugeruje odstępy w zależności od zadania.

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.

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 dodaje próby ponowne i pomocnika rotacji.

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

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