Utilizar o seu proxy

Estado e utilização

Cada dispositivo reporta se está a servir, qual é o seu IP de saída e quantos bytes moveu. Tudo isto aparece no dashboard e está disponível através da API.

Estado online

O estado é a visão do gateway sobre o túnel, não apenas se a app está aberta: online significa que o túnel de proxy está ativo e a servir, offline significa que está inativo, e unknown significa que o plano de controlo esteve momentaneamente inacessível. O telefone reporta um heartbeat continuamente, por isso last_seen diz-lhe se um dispositivo está instável.

Histórico de IP de saída

Cada dispositivo mantém um registo sem duplicados dos seus IPs de saída — uma nova entrada só quando o IP realmente mudou. É a forma fiável de confirmar que uma rotation produziu um novo endereço.

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

O servidor vigia a sua frota e levanta um alerta quando um IP se porta mal — sem configuração além de um limiar opcional. stale_ip: o dispositivo está online mas o seu IP de saída não muda há mais tempo do que o limiar que definiu por subscrição (cartão do dashboard ou stale_ip_alert_minutes no endpoint de rotation; desligado por omissão). duplicate_ip: dois dos seus dispositivos reportam o mesmo IP de saída (o NAT do operador pode atribuir a dois SIM um só endereço) — detetado automaticamente, rode um dispositivo para os separar. rotation_stuck: o dispositivo continua a rodar — comandos de rotação confirmados ou a sua rotation agendada — mas o IP de saída nunca muda, o que normalmente significa que perdeu a capacidade de alternar o modo de voo de que precisa para mudar de IP do operador. Sempre ativo, sem limiar a definir. Os alertas aparecem no sino do dashboard e no cartão afetado, e resolvem-se sozinhos assim que a condição 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áfego

Os bytes são contados no gateway, divididos por proxy — o que vê é o que o gateway realmente encaminhou. Útil para faturar clientes a quem revende.

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

Dica

Para um resumo agregado de toda a conta em todos os dispositivos, chame GET /api/v1/usage/summary.

SMS recebidos

Para telefones que possui, qualquer SMS que o SIM receba — códigos de verificação únicos (OTP), por exemplo — é encaminhado para o seu dashboard e listado do mais recente para o mais antigo por dispositivo. Depende da permissão opcional de receção de SMS da app; se a recusou no telefone, a lista fica vazia.

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

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

Os detalhes completos, campo a campo, estão na consola de API interativa.