API

Príručka k API

Všetko, čo robí dashboard — párovanie, prihlasovacie údaje, rotácia, spotreba — je jedno REST API. Základná URL https://mobileproxy.app/api/v1. Autentifikujte sa pomocou bearer tokenu.

Autentifikácia

Vytvorte token v dashboarde v časti Pre vývojárov → API tokeny alebo pomocou POST /tokens, keď ste prihlásení. Tajný kľúč sa zobrazí iba raz — uložte si ho. Posielajte ho pri každej požiadavke:

Authorization: Bearer mpx_live_…

Vyskúšajte naživo

Interaktívna konzola vám umožní vložiť token a volať každý endpoint priamo z prehliadača, s telami požiadaviek a reálnymi odpoveďami. Kompletná špecifikácia je na /api/v1/openapi.json.

Chyby

Chyby sú vo formáte JSON so zrozumiteľnou správou a strojovým kódom:

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

Pole	Typ	Popis
401	unauthorized	Token chýba, je poškodený alebo bol zrušený.
403	forbidden	Token je platný, ale nie je povolený.
404	not_found	Zdroj na tomto účte neexistuje.
502	control_plane_unavailable	Brána je krátko nedostupná — skúste znova.

Bežné postupy

Zobrazte svoje zariadenia so živým stavom a exit IP:

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

Zrotujte IP zariadenia a potvrďte to z histórie 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_…"

Vytvorte proxy pre nového zákazníka — jeden prihlasovací údaj, pripravený na odovzdanie:

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

Načítajte spotrebu za celý účet na fakturáciu:

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

Kompletná referencia

Každý endpoint, parameter, schéma a ukážková odpoveď sú v interaktívnej konzole. Vykresľuje sa naživo z toho istého OpenAPI dokumentu, z ktorého je API postavené, takže nikdy nezostane zastaraná.