# API de rotation IP proxy mobile : changez l’IP par lien ou appel API > Changez une IP proxy mobile 4G/5G par lien ou appel API : endpoints, code curl/Python/Node, limites 429. CellMast, sans KYC, paiement en crypto. - URL: https://cellmast.com/fr/ip-rotation-api/ - Dernière mise à jour: 2026-10-13 - Publisher: CellMast (https://cellmast.com) Chaque port dédié CellMast vient avec un lien de rotation que vous pouvez ouvrir dans un navigateur, un endpoint REST pour scripts, et une minuterie pour rotation automatique. Cette page montre les trois, avec limites et réponses. *Faites tourner puis vérifiez la nouvelle 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 ``` **Réponse rapide — Comment changer l’IP d’un proxy mobile par lien, API ou minuterie ?** Avec **CellMast**, ouvrez le lien de rotation de votre port, `https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY`, ou appelez le même endpoint en POST avec une clé Bearer. Le modem se reconnecte à l’opérateur et obtient une nouvelle IP. Chaque rotation reconnecte votre port à l’opérateur et prend généralement 5 à 15 secondes ; l’opérateur peut parfois rendre la même IP : il suffit de tourner à nouveau.. La rotation est incluse sur chaque port dédié 4G/5G, à partir de 2,63 $/jour, sans KYC et paiement en crypto. ## Rotation en un coup d’œil | Attribut | Valeur | | --- | --- | | Lien de rotation | `GET https://cellmast.com/api/v1/mobile/{port}/rotate?key=API_KEY` | | Appel script | `POST /api/v1/mobile/{portId}/rotate` avec `Authorization: Bearer API_KEY` | | Minuteur | `PATCH /api/v1/mobile/{portId}` avec `rotation.mode = interval`, de toutes les 2 minutes à toutes les 24 heures | | Ce qu’une rotation fait | Chaque rotation reconnecte votre port à l’opérateur et prend généralement 5 à 15 secondes ; l’opérateur peut parfois rendre la même IP : il suffit de tourner à nouveau. | | Intervalle minimum | 30 secondes entre deux rotations manuelles d’un même port ; les appels plus fréquents reçoivent un HTTP 429 avec `Retry-After` | | Réponse | Nouvelle IP, IP précédente, temps de rotation, prochaine rotation autorisée | | Même IP de retour ? | Possible : le fournisseur choisit l’adresse dans son pool | | Coût | Inclus pour chaque port dédié ; pas de frais par rotation | | Portée de la clé | Clé API avec la portée `proxies` | ## 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. *Tourner avec le lien (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" ``` ## 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. *POST /api/v1/mobile/{portId}/rotate* ```bash curl -X POST "https://cellmast.com/api/v1/mobile/PORT_ID/rotate" \ -H "Authorization: Bearer API_KEY" ``` *Exemple de réponse (200)* ```json { "ip": "203.0.113.24", "previousIp": "198.51.100.7", "rotatedAt": "2026-10-13T09:41:07Z", "nextRotationAvailableAt": "2026-10-13T09:41:37Z" } ``` Les adresses et horaires dans l’exemple sont illustratifs. `previousIp` permet à votre code de vérifier que l’opérateur a bien donné une nouvelle adresse. ## 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](https://cellmast.com/fr/guides/mobile-ip-rotation-strategy/) suggère des intervalles adaptés selon les usages. *Exemple de réponse (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" } } ``` ## 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. *Tourner toutes les 10 minutes* ```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}}' ``` ## 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](https://cellmast.com/fr/guides/python-mobile-proxy/) ajoute des tentatives et un helper de rotation. *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+ (enregistrer comme 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); } ``` ## 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](https://cellmast.com/fr/mobile-proxies/rotating/) 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. ## Rotation : questions ### Combien de temps prend un changement d’IP sur un proxy mobile ? Sur un port dédié CellMast, généralement 5 à 15 secondes : le modem se déconnecte de l’opérateur puis se reconnecte, et l’opérateur attribue une adresse. Pendant ce temps le port ne transporte pas de trafic, donc suspendez vos requêtes jusqu’à ce que l’API retourne la nouvelle IP. ### Y a-t-il une limite au nombre de rotations ? Les rotations ne coûtent rien de plus. L'API impose une seule limite : au maximum une rotation manuelle toutes les 30 secondes par port. Un minuteur peut être réglé de toutes les 2 minutes à toutes les 24 heures. ### Pourquoi ai-je eu la même IP après la rotation ? Parce que c'est le carrier qui choisit l'adresse. Les carriers partagent des adresses IPv4 publiques entre plusieurs abonnés via le CGNAT, et une reconnexion peut aboutir à la même adresse. Vérifiez `previousIp` dans la réponse et faites une nouvelle rotation après 30 secondes si vous avez besoin d'une adresse différente. Voir le [guide CGNAT](https://cellmast.com/fr/guides/cgnat-mobile-ips/). ### Le lien de rotation est-il sûr à partager ? Seulement avec les personnes qui peuvent contrôler le port. Le lien contient une clé API : toute personne la possédant peut faire tourner votre port, et la même clé dans un appel API peut aussi modifier les réglages de vos ports, les sous-utilisateurs ou la liste blanche d'IP. Utilisez une clé séparée pour les liens de rotation, préférez l’endpoint POST avec la clé dans un en-tête dans les scripts, et révoquez la clé dans l’espace client si le lien fuit. ### Puis-je choisir la prochaine IP ou garder une IP indéfiniment ? Non. Le carrier attribue les adresses, donc personne ne peut choisir la suivante, et un carrier peut changer une adresse de son propre chef. Si vous avez besoin de la même adresse longtemps, réglez la rotation en manuel et évitez la reconnexion ; si vous avez besoin d’une IP fixe pour une liste blanche, un proxy mobile 4G n’est pas le bon produit. **Rotation incluse sur chaque port** Ports dédiés 4G/5G à partir de 2,63 $/jour, données illimitées, rotation via lien, API ou minuteur. Payer en crypto. [Voir les prix des ports](https://cellmast.com/fr/pricing/) · [Référence API mobile](https://cellmast.com/docs/api/mobile/) --- CellMast: CellMast est un fournisseur de proxy mobile 4G/5G : modems carrier dédiés avec trafic illimité, plus une piscine mobile tournante facturée au GB, payée en crypto sans téléchargement d'identité.