API

API rokasgrāmata

Viss, ko dara vadības panelis — savienošana, akreditācijas dati, rotācija, lietojums — ir viens REST API. Bāzes URL https://mobileproxy.app/api/v1. Autentificējieties ar bearer marķieri.

Autentifikācija

Izveidojiet marķieri vadības panelī sadaļā Izstrādātājiem → API marķieri vai ar POST /tokens, kad esat pierakstījies. Noslēpums tiek parādīts tikai vienreiz — saglabājiet to. Nosūtiet to katrā pieprasījumā:

Authorization: Bearer mpx_live_…

Izmēģiniet tiešraidē

Interaktīvā konsole ļauj ielīmēt marķieri un izsaukt katru galapunktu no pārlūkprogrammas ar pieprasījumu ķermeņiem un reāliem atbildēm. Pilnā specifikācija ir pieejama /api/v1/openapi.json.

Kļūdas

Kļūdas ir JSON ar cilvēkam saprotamu ziņojumu un mašīnas kodu:

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

Lauks	Tips	Apraksts
401	unauthorized	Marķieris trūkst, ir bojāts vai atsaukts.
403	forbidden	Marķieris ir derīgs, bet nav atļauts.
404	not_found	Resurss šajā kontā neeksistē.
502	control_plane_unavailable	Vārteja īslaicīgi nesasniedzama — mēģiniet vēlreiz.

Biežākie scenāriji

Uzskaitiet savas ierīces ar tiešraides statusu un izejas IP:

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

Rotējiet ierīces IP un apstipriniet to IP vēsturē:

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

Nodrošiniet proxy jaunam klientam — viens akreditācijas dats, gatavs nodošanai:

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

Nolasiet konta mēroga lietojumu norēķiniem:

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

Pilnā atsauce

Katrs galapunkts, parametrs, shēma un atbildes piemērs ir interaktīvajā konsolē. Tā tiek renderēta tiešraidē no tā paša OpenAPI dokumenta, no kura ir veidots API, tāpēc tā nekad nenoveco.