Utiliser votre proxy
Statut et consommation
Chaque appareil indique s'il est en service, quelle est son IP de sortie et combien d'octets il a transférés. Tout cela s'affiche dans le dashboard et est disponible via l'API.
Statut en ligne
Le statut est la vue de la passerelle sur le tunnel, pas seulement le fait que l'application soit ouverte : online signifie que le tunnel proxy est actif et en service, offline qu'il est hors service, et unknown que le plan de contrôle était brièvement injoignable. Le téléphone envoie un heartbeat en continu, donc last_seen vous indique si un appareil clignote.
Historique des IP de sortie
Chaque appareil tient un journal dédoublonné de ses IP de sortie — une nouvelle entrée seulement quand l'IP a réellement changé. C'est la façon fiable de confirmer qu'une rotation a produit une nouvelle adresse.
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/ip-history \
-H "Authorization: Bearer mpx_live_…"
# → { "ip_history": [ { "ip": "77.136.66.63", "carrier": "SFR", "ts": "…" }, … ] }Alertes IP
Le serveur surveille votre parc et déclenche une alerte lorsqu'une IP se comporte mal — sans configuration au-delà d'un seuil optionnel. stale_ip : l'appareil est en ligne mais son IP de sortie n'a pas changé depuis plus longtemps que le seuil que vous définissez par abonnement (carte du dashboard ou stale_ip_alert_minutes sur l'endpoint de rotation ; désactivé par défaut). duplicate_ip : deux de vos appareils signalent la même IP de sortie (le NAT de l'opérateur peut attribuer une adresse à deux SIM) — détecté automatiquement, faites tourner un appareil pour les séparer. rotation_stuck : l'appareil continue de tourner — commandes de rotation acquittées ou sa rotation planifiée — mais l'IP de sortie ne change jamais, ce qui signifie généralement qu'il a perdu la capacité de bascule du mode Avion dont il a besoin pour changer d'IP opérateur. Toujours active, aucun seuil à définir. Les alertes apparaissent dans la cloche du dashboard et sur la carte concernée, et se résolvent d'elles-mêmes une fois la condition disparue.
# Alert after 60 min without an IP change
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation \
-H "Authorization: Bearer mpx_live_…" \
-H "Content-Type: application/json" \
-d '{ "stale_ip_alert_minutes": 60 }'
# Poll open alerts from your own monitoring
curl https://mobileproxy.app/api/v1/alerts -H "Authorization: Bearer mpx_live_…"
# → { "alerts": [ { "kind": "stale_ip", "sub_name": "Galaxy S8",
# "message": "IP unchanged for 75 min (alert threshold 60 min) — still 77.136.66.44",
# … } ], "unseen": 1 }Trafic
Les octets sont comptés à la passerelle, répartis par proxy — ce que vous voyez est ce que la passerelle a réellement relayé. Utile pour facturer les clients à qui vous revendez.
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/traffic \
-H "Authorization: Bearer mpx_live_…"
# → { "bytes_sent": …, "bytes_recv": …, "bytes_total": …,
# "per_proxy": [ { "proxy_id": "…", "bytes_sent": …, "bytes_recv": … } ] }GET /api/v1/usage/summary.SMS reçus
Pour les téléphones que vous possédez, tout SMS que la SIM reçoit — codes de vérification à usage unique (OTP), par exemple — est transféré vers votre dashboard et listé du plus récent au plus ancien par appareil. Cela dépend de l'autorisation optionnelle de réception de SMS de l'application ; si vous l'avez refusée sur le téléphone, la liste reste vide.
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/sms \
-H "Authorization: Bearer mpx_live_…"
# → { "messages": [ { "sender": "+15550101", "body": "code 314159", "received_at": "…" }, … ] }Les détails complets, champ par champ, sont dans la console API interactive.