API

API juhend

Kõik, mida töölaud teeb — sidumine, mandaadid, rotatsioon, kasutus — on üks REST API. Baas-URL https://mobileproxy.app/api/v1. Autendi end bearer-tokeniga.

Autentimine

Loo token töölaual jaotises Arendajatele → API tokenid või käsuga POST /tokens, kui oled sisse logitud. Saladust näidatakse ainult üks kord — salvesta see. Saada see iga päringuga kaasa:

Authorization: Bearer mpx_live_…

Proovi kohe järele

Interaktiivne konsool laseb sul kleepida tokeni ja kutsuda igat lõpp-punkti otse brauserist koos päringukehade ja reaalsete vastustega. Täisspetsifikatsioon on aadressil /api/v1/openapi.json.

Vead

Vead on JSON-kujul, inimloetava sõnumi ja masinkoodiga:

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

Väli	Tüüp	Kirjeldus
401	unauthorized	Token puudub, on vigane või tühistatud.
403	forbidden	Token on kehtiv, kuid pole lubatud.
404	not_found	Ressurssi sellel kontol ei ole.
502	control_plane_unavailable	Lüüs oli hetkeks kättesaamatu — proovi uuesti.

Levinud retseptid

Kuva oma seadmed koos reaalajas oleku ja väljumis-IP-ga:

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

Roteeri seadme IP-d ja kinnita see IP ajaloost:

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

Loo uuele kliendile proxy — üks mandaat, valmis üleandmiseks:

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

Loe kontoülest kasutust arveldamiseks:

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

Täielik viide

Iga lõpp-punkt, parameeter, skeem ja näidisvastus on interaktiivses konsoolis. See renderdatakse reaalajas samast OpenAPI dokumendist, millele API on üles ehitatud, seega ei jää see kunagi ajast maha.