Mobile Proxy IP-Rotations-API: IP per Link oder API-Aufruf ändern

Wie funktioniert der Rotationslink?

Der Rotationslink ist eine einfache URL mit Ihrer Port-ID (sie sieht aus wie mob_2v8k1q; im Kundenbereich sehen Sie für jeden Port den fertigen Link) und einem API-Schlüssel darin. Das Öffnen des Links im Browser, Lesezeichen oder Skript fordert das Modem auf, die Verbindung zum Betreiber zu trennen und neu herzustellen. Der Betreiber weist dann eine IP-Adresse zu, meist eine andere.

Fügen Sie &format=text hinzu, um nur die neue IP als einfachen Text zu erhalten, was in Shell-Skripten praktisch ist. Behandeln Sie den Link wie ein Passwort: Jeder, der ihn hat, kann Ihren Port rotieren, und derselbe Schlüssel in einem API-Aufruf kann auch Ihre Port-Einstellungen, Unterbenutzer oder IP-Allowlist ändern. Erstellen Sie einen separaten Schlüssel nur für Rotationslinks, halten Sie den Link aus geteilten Dokumenten und Chatvorschauen fern und widerrufen Sie den Schlüssel im Kundenbereich bei Leckage.

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

Wie rotiere ich aus einem Skript mit der REST API?

Skripte sollten POST verwenden mit dem Schlüssel im Authorization Header, damit der Schlüssel nicht in Server-Logs oder Browser-Verlauf erscheint. Die Antwort gibt die neue IP und den Zeitpunkt der nächsten erlaubten Rotation zurück.

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

Was passiert, wenn ich zu oft rotiere?

Ein Port akzeptiert maximal eine manuelle Rotation alle 30 Sekunden. Ein Aufruf davor liefert HTTP 429 mit dem Fehler rotation_too_soon und einem Retry-After Header, der die Wartezeit in Sekunden angibt. Nichts bricht: Der Port behält seine aktuelle IP.

So schnell wie möglich zu rotieren ist selten sinnvoll. Während jeder Wiederverbindung trägt der Port keinen Traffic, und ein Betreiber kann dieselbe Adresse zurückgeben. Der Rotationsstrategie-Guide empfiehlt Intervalle je Aufgabe.

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

Wie stelle ich automatische Rotation auf einem Timer ein?

Setzen Sie den Rotationsmodus des Ports auf interval und wählen Sie eine Anzahl Minuten zwischen 2 und 1.440 (alle 2 Minuten bis alle 24 Stunden). Der Timer rotiert dann den Port ohne einen Aufruf Ihrerseits. Schalten Sie zurück auf manual, um es zu stoppen. Sie können den Timer auch im Kundenbereich einstellen.

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

Wie rotiere ich in Python oder Node.js?

Beide Beispiele rotieren den Port und geben die neue IP aus; das Python-Beispiel sendet danach eine Anfrage über den Port. Der Python-Guide ergänzt Wiederholungen und einen Rotationshelfer.

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

Kann ich einen Port zu einem anderen Betreiber, einer anderen Stadt oder einem anderen Land verschieben?

Fragen Sie den Support. Benötigen Sie ein anderes Land? Fragen Sie den Support: Wenn dort ein Port verfügbar ist, übertragen wir Ihre verbleibenden Tage dorthin und gleichen die Preisdifferenz über Ihr Guthaben aus (ein Wechsel pro Abrechnungszeitraum). Das Gleiche gilt für einen anderen Betreiber oder eine andere Stadt im gleichen Land. Nach dem Umzug können Host, Port und Passwort sich ändern: Lesen Sie diese Werte im Kundenbereich erneut aus.

Kann ich sehen, welche IPs mein Port verwendet hat?

Ja. GET /api/v1/mobile/{portId}/ip-history listet die Adressen auf, die dem Port mit Zeiten zugewiesen wurden. Nutzen Sie es, um zu überprüfen, ob Rotationen neue Adressen liefern, um Ihre eigenen Logs abzugleichen oder um zu bestätigen, dass jede Adresse zum gewählten Betreiber gehört. GET /api/v1/mobile/{portId}/usage zeigt tagesbezogenen Traffic als Information; Daten auf einem Dedicated Port sind unbegrenzt.

Braucht der rotierende per-GB-Pool diese API?

Nein. Der rotierende mobile Pool wechselt IPs automatisch: Jede neue Verbindung erhält eine IP aus dem Pool, meistens eine andere; für eine neue IP bei jeder Anfrage, sende pro Verbindung nur eine Anfrage (keep-alive ausschalten).. Sie steuern ihn über den Benutzernamen, z.B. USERNAME-country-us-session-abc123-ttl-15 für eine Sticky-Session von 15 Minuten. Die Rotations-API ist für Dedicated Ports, bei denen ein Modem Ihnen gehört und Sie bestimmen, wann die IP wechselt.