API

Průvodce API

Vše, co dělá dashboard — párování, přihlašovací údaje, rotace, spotřeba — je jedno REST API. Základní URL https://mobileproxy.app/api/v1. Ověřte se pomocí bearer tokenu.

Ověření

Vytvořte token v dashboardu v sekci Pro vývojáře → API tokeny nebo přes POST /tokens, když jste přihlášeni. Tajný klíč se zobrazí jen jednou — uložte si ho. Posílejte ho s každým požadavkem:

Authorization: Bearer mpx_live_…

Vyzkoušejte naživo

Interaktivní konzole umožňuje vložit token a volat každý endpoint přímo z prohlížeče, s těly požadavků a reálnými odpověďmi. Kompletní specifikace je na /api/v1/openapi.json.

Chyby

Chyby jsou ve formátu JSON se srozumitelnou zprávou a strojovým kódem:

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

Pole	Typ	Popis
401	unauthorized	Token chybí, je poškozený nebo zrušený.
403	forbidden	Token je platný, ale nemá oprávnění.
404	not_found	Zdroj na tomto účtu neexistuje.
502	control_plane_unavailable	Brána je krátce nedostupná — zkuste to znovu.

Časté postupy

Vypište svá zařízení s živým stavem a výstupní IP:

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

Rotujte IP zařízení a potvrďte to z historie 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_…"

Zřiďte proxy pro nového zákazníka — jeden přihlašovací údaj, připravený k předání:

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čtěte spotřebu za celý účet pro fakturaci:

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

Kompletní reference

Každý endpoint, parametr, schéma i ukázková odpověď jsou v interaktivní konzoli. Vykresluje se naživo ze stejného OpenAPI dokumentu, ze kterého je API postaveno, takže nikdy nezastará.