Usar tu proxy

Estado y uso

Cada dispositivo informa de si está sirviendo, cuál es su IP de salida y cuántos bytes ha movido. Todo se muestra en el panel y está disponible por la API.

Estado en línea

El estado es la visión que el gateway tiene del túnel, no solo si la app está abierta: online significa que el túnel del proxy está activo y sirviendo, offline que está caído, y unknown que el plano de control estuvo momentáneamente inaccesible. El teléfono reporta un heartbeat de forma continua, así que last_seen te dice si un dispositivo está inestable.

Historial de IP de salida

Cada dispositivo mantiene un registro deduplicado de sus IP de salida: una entrada nueva solo cuando la IP cambia de verdad. Es la forma fiable de confirmar que una rotación produjo una dirección nueva.

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

Alertas de IP

El servidor vigila tu flota y lanza una alerta cuando una IP se comporta mal, sin más configuración que un umbral opcional. stale_ip: el dispositivo está en línea pero su IP de salida no ha cambiado durante más tiempo que el umbral que fijes por suscripción (tarjeta del panel o stale_ip_alert_minutes en el endpoint de rotación; desactivado por defecto). duplicate_ip: dos de tus dispositivos reportan la misma IP de salida (el NAT del operador puede dar una dirección a dos SIM): se detecta automáticamente, rota un dispositivo para separarlas. rotation_stuck: el dispositivo sigue rotando —comandos de rotación confirmados o su rotación programada— pero la IP de salida nunca cambia, lo que suele significar que perdió la capacidad de alternar el modo avión que necesita para cambiar la IP del operador. Siempre activa, sin umbral que fijar. Las alertas aparecen en la campana del panel y en la tarjeta afectada, y se resuelven por sí solas cuando la condición desaparece.

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

Tráfico

Los bytes se cuentan en el gateway, desglosados por proxy: lo que ves es lo que el gateway realmente retransmitió. Útil para facturar a los clientes a los que revendes.

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

Consejo

Para un resumen agregado de toda la cuenta en todos los dispositivos, llama a GET /api/v1/usage/summary.

SMS recibidos

Para teléfonos que posees, cualquier SMS que reciba la SIM —códigos de verificación de un solo uso (OTP), por ejemplo— se reenvía a tu panel y se lista, los más recientes primero, por dispositivo. Depende del permiso opcional de recepción de SMS de la app; si lo rechazaste en el teléfono, la lista queda vacía.

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

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

Todos los detalles campo por campo están en la consola interactiva de la API.