API

API vadovas

Viskas, ką daro valdymo skydelis — susiejimas, prisijungimo duomenys, rotacija, naudojimas — tai vienas REST API. Bazinis URL https://mobileproxy.app/api/v1. Autentifikuokitės su bearer žetonu.

Autentifikavimas

Sukurkite žetoną valdymo skydelyje skiltyje Kūrėjams → API žetonai arba komanda POST /tokens būdami prisijungę. Slaptas raktas parodomas vieną kartą — išsaugokite jį. Siųskite jį su kiekvienu užklausimu:

Authorization: Bearer mpx_live_…

Išbandykite gyvai

Interaktyvi konsolė leidžia įklijuoti žetoną ir iškviesti kiekvieną galinį tašką tiesiai iš naršyklės su užklausų kūnais ir tikrais atsakymais. Visa specifikacija yra /api/v1/openapi.json.

Klaidos

Klaidos yra JSON su žmogui suprantamu pranešimu ir mašininiu kodu:

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

Laukas	Tipas	Aprašymas
401	unauthorized	Žetono nėra, jis netinkamas arba atšauktas.
403	forbidden	Žetonas galioja, bet neturi teisių.
404	not_found	Šioje paskyroje tokio ištekliaus nėra.
502	control_plane_unavailable	Šliuzas trumpam nepasiekiamas — pakartokite.

Dažni receptai

Peržiūrėkite savo įrenginius su realios būsenos ir išėjimo IP informacija:

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

Pakeiskite įrenginio IP ir patvirtinkite iš IP istorijos:

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

Paruoškite proxy naujam klientui — vieni prisijungimo duomenys, paruošti perduoti:

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

Nuskaitykite visos paskyros naudojimą atsiskaitymui:

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

Visas žinynas

Kiekvienas galinis taškas, parametras, schema ir atsakymo pavyzdys yra interaktyvioje konsolėje. Ji atvaizduojama gyvai iš to paties OpenAPI dokumento, iš kurio sukurtas API, todėl niekada nepasensta.