Je proxy gebruiken

Status & verbruik

Elk apparaat meldt of het bedient, wat zijn exit-IP is, en hoeveel bytes het heeft verplaatst. Alles verschijnt in het dashboard en is beschikbaar via de API.

Online status

Status is de kijk van de gateway op de tunnel, niet alleen of de app open is: online betekent dat de proxytunnel actief is en bedient, offline betekent dat hij down is, en unknown betekent dat de control plane even onbereikbaar was. De telefoon rapporteert continu een heartbeat, dus last_seen vertelt je of een apparaat wisselvallig is.

Exit-IP-geschiedenis

Elk apparaat houdt een ontdubbeld logboek van zijn exit-IP's bij — een nieuwe regel pas wanneer het IP echt is veranderd. Het is de betrouwbare manier om te bevestigen dat een rotatie een vers adres heeft opgeleverd.

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

IP-waarschuwingen

De server bewaakt je fleet en slaat alarm wanneer een IP zich misdraagt — geen setup afgezien van een optionele drempel. stale_ip: het apparaat is online maar het exit-IP is langer dan de drempel die je per abonnement instelt niet veranderd (dashboardkaart of stale_ip_alert_minutes op het rotatie-endpoint; standaard uit). duplicate_ip: twee van je apparaten rapporteren hetzelfde exit-IP (carrier-NAT kan twee SIM's één adres geven) — automatisch gedetecteerd, roteer één apparaat om ze te scheiden. rotation_stuck: het apparaat blijft roteren — bevestigde rotate-commando's of zijn geplande rotatie — maar het exit-IP verandert nooit, wat meestal betekent dat het de vliegtuigmodus-schakelfunctie kwijt is die het nodig heeft om het carrier-IP te wijzigen. Altijd aan, geen drempel in te stellen. Waarschuwingen verschijnen in de bel van het dashboard en op de betrokken kaart, en lossen zichzelf op zodra de conditie verdwijnt.

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

Verkeer

Bytes worden bij de gateway geteld, opgesplitst per proxy — wat je ziet is wat de gateway daadwerkelijk heeft doorgegeven. Handig voor het factureren van klanten aan wie je doorverkoopt.

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

Tip

Voor een accountbrede samenvatting over elk apparaat roep je GET /api/v1/usage/summary aan.

Ontvangen SMS

Voor telefoons die je bezit wordt elke SMS die de SIM ontvangt — bijvoorbeeld eenmalige verificatiecodes (OTP's) — doorgestuurd naar je dashboard en per apparaat nieuwste-eerst getoond. Het steunt op de optionele SMS-ontvangstpermissie van de app; heb je die op de telefoon geweigerd, dan blijft de lijst leeg.

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

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

Volledige details, veld voor veld, staan in de interactieve API-console.