API

Guía de la API

Todo lo que hace el panel — emparejamiento, credenciales, rotación, uso — es una única API REST. URL base https://mobileproxy.app/api/v1. Autentícate con un token bearer.

Autenticación

Crea un token en el panel, en Para desarrolladores → Tokens de API, o con POST /tokens con la sesión iniciada. El secreto se muestra una sola vez: guárdalo. Envíalo en cada petición:

Authorization: Bearer mpx_live_…

Pruébalo en vivo

La consola interactiva te permite pegar un token y llamar a cada endpoint desde el navegador, con cuerpos de petición y respuestas reales. La especificación completa está en /api/v1/openapi.json.

Errores

Los errores son JSON con un mensaje legible y un código para máquinas:

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

Campo	Tipo	Descripción
401	unauthorized	Token ausente, con formato incorrecto o revocado.
403	forbidden	Token válido pero sin permiso.
404	not_found	El recurso no existe en esta cuenta.
502	control_plane_unavailable	Gateway momentáneamente inaccesible: reintenta.

Recetas habituales

Lista tus dispositivos con estado en vivo e IP de salida:

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

Rota la IP de un dispositivo y confírmalo desde el historial 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_…"

Provisiona un proxy para un cliente nuevo: una credencial, lista para 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

Consulta el uso de toda la cuenta para facturación:

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

Referencia completa

Cada endpoint, parámetro, esquema y respuesta de ejemplo está en la consola interactiva. Se genera en vivo a partir del mismo documento OpenAPI con el que se construye la API, así que nunca queda desactualizada.