API

Guida API

Tutto ciò che fa la dashboard — pairing, credenziali, rotazione, utilizzo — è un'unica API REST. Base URL https://mobileproxy.app/api/v1. Autenticati con un bearer token.

Autenticazione

Crea un token nella dashboard in Per gli sviluppatori → Token API, oppure con POST /tokens mentre sei autenticato. Il segreto viene mostrato una sola volta — conservalo. Invialo a ogni richiesta:

Authorization: Bearer mpx_live_…

Provala dal vivo

La console interattiva ti permette di incollare un token e chiamare ogni endpoint dal browser, con corpi di richiesta e risposte reali. La specifica completa è su /api/v1/openapi.json.

Errori

Gli errori sono in JSON con un messaggio leggibile e un codice per le macchine:

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

Campo	Tipo	Descrizione
401	unauthorized	Token mancante, malformato o revocato.
403	forbidden	Token valido ma non autorizzato.
404	not_found	La risorsa non esiste su questo account.
502	control_plane_unavailable	Gateway momentaneamente irraggiungibile — riprova.

Ricette comuni

Elenca i tuoi dispositivi con stato in tempo reale e IP di uscita:

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

Ruota l'IP di un dispositivo e conferma dallo storico 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 per un nuovo cliente — una credenziale, pronta da consegnare:

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

Leggi l'utilizzo su tutto l'account per la fatturazione:

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

Riferimento completo

Ogni endpoint, parametro, schema ed esempio di risposta si trova nella console interattiva. Viene generata dal vivo dallo stesso documento OpenAPI su cui è costruita l'API, quindi non si disallinea mai.