API de rotation IP proxy mobile : changez l’IP par lien ou appel API

Comment fonctionne le lien de rotation ?

Le lien de rotation est une URL simple avec l’ID de votre port (il ressemble à mob_2v8k1q ; l’espace client affiche le lien prêt à l’emploi pour chaque port) et une clé API intégrée. L’ouvrir, dans un navigateur, un favori ou un script, demande au modem de couper la connexion avec l’opérateur puis de se reconnecter. L’opérateur assigne alors une adresse IP, généralement différente.

Ajoutez &format=text pour ne récupérer que la nouvelle IP en texte brut, pratique dans les scripts shell. Traitez ce lien comme un mot de passe : toute personne qui l’a peut faire tourner votre port, et la même clé utilisée dans un appel API peut aussi modifier les paramètres de vos ports, sous-utilisateurs ou liste blanche d’IP. Créez une clé distincte uniquement pour les liens de rotation, gardez le lien hors des documents partagés et des aperçus de chats, et révoquez la clé dans l’espace client en cas de fuite.

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

Comment tourner depuis un script avec l’API REST ?

Les scripts doivent utiliser POST avec la clé dans l’en-tête Authorization, pour que la clé ne soit pas enregistrée dans les logs serveur ni dans l’historique du navigateur. La réponse indique la nouvelle IP et quand la prochaine rotation est autorisée.

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

Que se passe-t-il si je tourne trop souvent ?

Un port accepte au maximum une rotation manuelle toutes les 30 secondes. Un appel avant ce délai renvoie un HTTP 429 avec l’erreur rotation_too_soon et un en-tête Retry-After indiquant les secondes à attendre. Rien ne se brise : le port conserve son IP actuelle.

Tourner aussi rapidement que possible est rarement utile. Durant chaque reconnexion, le port ne transporte aucun trafic, et un opérateur peut redonner la même adresse. Le guide de stratégie de rotation suggère des intervalles adaptés selon les usages.

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

Comment configurer la rotation automatique avec un minuteur ?

Réglez le mode de rotation du port sur interval et choisissez un nombre de minutes entre 2 et 1440 (de toutes les 2 minutes à toutes les 24 heures). Le minuteur fera ensuite tourner le port sans intervention de votre part. Revenez à manual pour l’arrêter. Vous pouvez aussi paramétrer ce minuteur depuis l’espace client.

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

Comment tourner en Python ou Node.js ?

Les deux exemples font tourner le port et affichent la nouvelle IP ; l’exemple Python envoie ensuite une requête via le port. Le guide Python ajoute des tentatives et un helper de rotation.

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

Puis-je déplacer un port vers un autre opérateur, ville ou pays ?

Contactez le support. Besoin d'un autre pays ? Contactez le support : si un port est disponible là-bas, nous transférons vos jours restants dessus et réglons la différence de prix via votre solde (un transfert par période de facturation). Cela s’applique aussi pour un autre opérateur ou une autre ville dans le même pays. Après un déplacement, l’hôte, le port et le mot de passe peuvent changer : relevez-les à nouveau dans l’espace client.

Puis-je voir quelles IP mon port a utilisées ?

Oui. GET /api/v1/mobile/{portId}/ip-history liste les adresses assignées au port avec leurs horaires. Utilisez-le pour vérifier que les rotations produisent bien de nouvelles adresses, pour comparer à vos propres logs, ou pour confirmer que chaque adresse appartient bien à l’opérateur choisi. GET /api/v1/mobile/{portId}/usage affiche le trafic journalier pour info ; les données sur un port dédié sont illimitées.

La pool mobile rotative par GB nécessite-t-elle cette API ?

Non. La pool mobile rotative change d’IP toute seule : Chaque nouvelle connexion obtient une IP du pool, généralement différente ; pour une nouvelle IP à chaque requête, envoyez une requête par connexion (désactivez keep-alive). Vous la contrôlez avec le nom d’utilisateur, par exemple USERNAME-country-us-session-abc123-ttl-15 pour une session sticky de 15 minutes. L’API de rotation est destinée aux ports dédiés, où un modem est à vous et vous décidez quand son IP change.