API

Guia da API

Tudo o que o dashboard faz — emparelhamento, credenciais, rotation, utilização — é uma REST API. URL base https://mobileproxy.app/api/v1. Autentique-se com um bearer token.

Autenticação

Crie um token no dashboard em Para programadores → Tokens de API, ou com POST /tokens depois de iniciar sessão. O segredo é mostrado uma única vez — guarde-o. Envie-o em todos os pedidos:

Authorization: Bearer mpx_live_…

Experimente em direto

A consola interativa permite colar um token e chamar todos os endpoints a partir do browser, com corpos de pedido e respostas reais. A especificação completa está em /api/v1/openapi.json.

Erros

Os erros são JSON com uma mensagem legível e um código de máquina:

{ "error": "No such device.", "code": "not_found" }

Campo	Tipo	Descrição
401	unauthorized	Token em falta, malformado ou revogado.
403	forbidden	Token válido mas sem permissão.
404	not_found	O recurso não existe nesta conta.
502	control_plane_unavailable	Gateway momentaneamente inacessível — tente novamente.

Receitas comuns

Liste os seus dispositivos com estado em direto e IP de saída:

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

Rode o IP de um dispositivo e confirme através do histórico de IP:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…"

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

Aprovisione um proxy para um novo cliente — uma credencial, pronta a entregar:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…"
# → returns endpoint: socks5h://user:pass@host:port

Leia a utilização de toda a conta para faturação:

curl https://mobileproxy.app/api/v1/usage/summary \
     -H "Authorization: Bearer mpx_live_…"

Referência completa

Todos os endpoints, parâmetros, esquemas e exemplos de resposta estão na consola interativa. É gerada em direto a partir do mesmo documento OpenAPI que constrói a API, por isso nunca fica desatualizada.