API

API-opas

Kaikki, mitä hallintapaneeli tekee — laiteparitus, tunnukset, rotaatio, käyttö — on yhtä REST-rajapintaa. Perus-URL https://mobileproxy.app/api/v1. Todennu bearer-tokenilla.

Todennus

Luo token hallintapaneelissa kohdasta Kehittäjille → API-tokenit tai komennolla POST /tokens kirjautuneena. Salaisuus näytetään kerran — tallenna se. Lähetä se jokaisessa pyynnössä:

Authorization: Bearer mpx_live_…

Kokeile suoraan

Interaktiivisessa konsolissa voit liittää tokenin ja kutsua jokaista päätepistettä selaimesta, pyyntörungoilla ja aidoilla vastauksilla. Täysi määrittely on osoitteessa /api/v1/openapi.json.

Virheet

Virheet ovat JSON-muotoisia ihmisluettavalla viestillä ja konekoodilla:

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

Kenttä	Tyyppi	Kuvaus
401	unauthorized	Token puuttuu, on virheellinen tai peruttu.
403	forbidden	Token on kelvollinen mutta ei salli tätä.
404	not_found	Resurssia ei ole tällä tilillä.
502	control_plane_unavailable	Yhdyskäytävä hetkellisesti tavoittamattomissa — yritä uudelleen.

Yleiset reseptit

Listaa laitteesi reaaliaikaisella tilalla ja ulostulo-IP:llä:

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

Rotaatio laitteen IP:lle ja vahvistus IP-historiasta:

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

Provisioi proxy uudelle asiakkaalle — yksi tunnus, valmis luovutettavaksi:

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

Lue tilinlaajuinen käyttö laskutusta varten:

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

Täysi viite

Jokainen päätepiste, parametri, skeema ja esimerkkivastaus on interaktiivisessa konsolissa. Se piirtyy reaaliaikaisesti samasta OpenAPI-dokumentista, josta API on rakennettu, joten se ei koskaan vanhene.