Usare il tuo proxy

Stato e utilizzo

Ogni dispositivo riporta se sta servendo, qual è il suo IP di uscita e quanti byte ha trasferito. Tutto questo compare nella dashboard ed è disponibile tramite l'API.

Stato online

Lo stato è la visione del tunnel da parte del gateway, non solo se l'app è aperta: online significa che il tunnel proxy è attivo e sta servendo, offline significa che è inattivo, e unknown significa che il control plane è stato momentaneamente irraggiungibile. Il telefono riporta un heartbeat di continuo, quindi last_seen ti dice se un dispositivo è instabile.

Storico degli IP di uscita

Ogni dispositivo mantiene un registro deduplicato dei suoi IP di uscita — una nuova voce solo quando l'IP è effettivamente cambiato. È il modo affidabile per confermare che una rotazione ha prodotto un indirizzo nuovo.

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": "…" }, … ] }

Avvisi IP

Il server sorveglia la tua flotta e solleva un avviso quando un IP si comporta male — nessuna configurazione oltre a una soglia facoltativa. stale_ip: il dispositivo è online ma il suo IP di uscita non cambia da più della soglia che imposti per abbonamento (scheda della dashboard o stale_ip_alert_minutes sull'endpoint di rotazione; disattivato per impostazione predefinita). duplicate_ip: due dei tuoi dispositivi riportano lo stesso IP di uscita (il NAT dell'operatore può assegnare un unico indirizzo a due SIM) — rilevato automaticamente, ruota un dispositivo per separarli. rotation_stuck: il dispositivo continua a ruotare — comandi di rotazione confermati o la sua rotazione programmata — ma l'IP di uscita non cambia mai, il che di solito significa che ha perso la capacità di attivare la modalità aereo necessaria per cambiare l'IP dell'operatore. Sempre attivo, nessuna soglia da impostare. Gli avvisi compaiono nella campanella della dashboard e sulla scheda interessata, e si risolvono da soli una volta che la condizione cessa.

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

Traffico

I byte sono conteggiati al gateway, suddivisi per proxy — ciò che vedi è ciò che il gateway ha effettivamente instradato. Utile per fatturare i clienti a cui rivendi.

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": … } ] }

Suggerimento

Per un riepilogo su tutto l'account, su ogni dispositivo, chiama GET /api/v1/usage/summary.

SMS ricevuti

Per i telefoni che possiedi, qualsiasi SMS ricevuto dalla SIM — i codici di verifica monouso (OTP), per esempio — viene inoltrato alla tua dashboard ed elencato dal più recente per ogni dispositivo. Si basa sul permesso opzionale di ricezione SMS dell'app; se lo hai rifiutato sul telefono, l'elenco resta vuoto.

curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/sms \
     -H "Authorization: Bearer mpx_live_…"

# → { "messages": [ { "sender": "+15550101", "body": "code 314159", "received_at": "…" }, … ] }

Tutti i dettagli campo per campo si trovano nella console API interattiva.