API

API vodič

Sve što nadzorna ploča radi — uparivanje, vjerodajnice, rotaciju, potrošnju — čini jedan REST API. Osnovni URL https://mobileproxy.app/api/v1. Autentificirajte se bearer tokenom.

Autentifikacija

Izradite token u nadzornoj ploči pod Za razvojne inženjere → API tokeni ili s POST /tokens dok ste prijavljeni. Tajna se prikazuje jednom — pohranite je. Šaljite je uz svaki zahtjev:

Authorization: Bearer mpx_live_…

Isprobajte uživo

Interaktivna konzola omogućuje vam da zalijepite token i pozovete svaku krajnju točku iz preglednika, s tijelima zahtjeva i stvarnim odgovorima. Cijela specifikacija nalazi se na /api/v1/openapi.json.

Pogreške

Pogreške su JSON s razumljivom porukom i strojnim kodom:

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

Polje	Tip	Opis
401	unauthorized	Token nedostaje, neispravan je ili je opozvan.
403	forbidden	Token je valjan, ali nema dopuštenje.
404	not_found	Resurs ne postoji na ovom računu.
502	control_plane_unavailable	Pristupnik je nakratko nedostupan — pokušajte ponovno.

Uobičajeni recepti

Popišite svoje uređaje s aktualnim statusom i izlaznim IP-om:

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

Rotirajte IP uređaja i potvrdite iz povijesti IP-ova:

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_…"

Pripremite proxy za novog korisnika — jedna vjerodajnica, spremna za predaju:

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

Pročitajte potrošnju cijelog računa za naplatu:

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

Potpuna referenca

Svaka krajnja točka, parametar, shema i primjer odgovora nalaze se u interaktivnoj konzoli. Prikazuje se uživo iz istog OpenAPI dokumenta iz kojeg je API izgrađen, pa nikad ne zastarijeva.