Mobile proxy IP rotation API: verander het IP via link of API-aanroep

Hoe werkt de rotatielink?

De rotatielink is een gewone URL met je poort-ID (het ziet eruit als mob_2v8k1q; in het klantdashboard staat de kant-en-klare link van elke poort) en een API-sleutel erin. Het openen ervan, in een browser, bladwijzer of script, vraagt de modem om de verbinding met de provider te verbreken en opnieuw te verbinden. De provider wijst dan een IP-adres toe, meestal een ander.

Voeg &format=text toe om alleen het nieuwe IP als platte tekst te krijgen, handig in shell-scripts. Behandel de link als een wachtwoord: iedereen die hem heeft kan je poort roteren, en dezelfde sleutel die in een API-aanroep wordt meegegeven kan ook de instellingen van je poorten, subgebruikers of IP-toegangslista wijzigen. Maak een aparte sleutel alleen voor rotatielinks, houd de link buiten gedeelde documenten en chatvoorvertoningen, en herroep de sleutel in het klantdashboard als hij uitlekt.

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

Hoe roteer ik vanuit een script met de REST API?

Scripts moeten POST gebruiken met de sleutel in de Authorization header, zodat de sleutel niet in serverlogs of browsergeschiedenis terechtkomt. De respons vertelt je het nieuwe IP en wanneer de volgende rotatie is toegestaan.

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

Wat gebeurt er als ik te vaak roteer?

Een poort accepteert maximaal één handmatige rotatie per 30 seconden. Een oproep eerder dan dat geeft HTTP 429 met de fout rotation_too_soon en een Retry-After header die het aantal seconden wachttijd aangeeft. Niets gaat stuk: de poort behoudt zijn huidige IP.

Zo snel mogelijk roteren heeft zelden zin. Tijdens elke herverbinding draagt de poort geen verkeer, en een provider kan hetzelfde adres teruggeven. De rotatiestrategiegids adviseert intervallen per taak.

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

Hoe stel ik automatische rotatie in op een timer?

Stel de rotatiemodus van de poort in op interval en kies een aantal minuten van 2 tot 1.440 (elke 2 minuten tot elke 24 uur). De timer roteert dan de poort zonder dat jij iets hoeft aan te roepen. Schakel terug naar manual om te stoppen. Je kunt de timer ook instellen vanuit het klantdashboard.

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

Hoe roteer ik in Python of Node.js?

Beide voorbeelden roteren de poort en tonen het nieuwe IP; het Python-voorbeeld stuurt daarna een verzoek via de poort. De Python-gids voegt retries en een rotatiehelper toe.

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

Kan ik een poort naar een andere provider, stad of land verplaatsen?

Vraag support. Een ander land nodig? Vraag support: als er een port beschikbaar is, verplaatsen we je resterende dagen daar naartoe en verrekenen we het prijsverschil via je balans (één verplaatsing per factureringsperiode). Hetzelfde geldt voor een andere provider of stad in hetzelfde land. Na een verhuizing kunnen host, poort en wachtwoord veranderen: lees ze opnieuw in het klantdashboard.

Kan ik zien welke IP's mijn poort heeft gebruikt?

Ja. GET /api/v1/mobile/{portId}/ip-history toont de adressen die aan de poort zijn toegewezen met hun tijden. Gebruik het om te controleren of rotaties nieuwe adressen opleveren, om je eigen logs te matchen of om te bevestigen dat elk adres toebehoort aan de gekozen provider. GET /api/v1/mobile/{portId}/usage toont dagelijks verkeer ter informatie; data op een dedicated poort is onbeperkt.

Heeft het roterende per-GB pool deze API nodig?

Nee. De rotating mobile pool verandert zelf het IP: Elke nieuwe verbinding krijgt een IP uit de pool, meestal een ander; voor een nieuw IP bij elk verzoek, zend één verzoek per verbinding (zet keep-alive uit). Je regelt het met de gebruikersnaam, bijvoorbeeld USERNAME-country-us-session-abc123-ttl-15 voor een sticky sessie van 15 minuten. De rotatie-API is voor dedicated poorten, waarbij één modem van jou is en jij bepaalt wanneer het IP verandert.