API

API-gids

Alles wat het dashboard doet — koppelen, credentials, rotatie, verbruik — zit in één REST API. Basis-URL https://mobileproxy.app/api/v1. Authenticeer met een bearer-token.

Authenticatie

Maak een token aan in het dashboard onder Voor ontwikkelaars → API-tokens, of met POST /tokens terwijl je bent ingelogd. Het geheim wordt één keer getoond — bewaar het. Stuur het bij elk verzoek mee:

Authorization: Bearer mpx_live_…

Probeer het live

In de interactieve console plak je een token en roep je vanuit de browser elk endpoint aan, met request-bodies en echte responses. De volledige spec staat op /api/v1/openapi.json.

Fouten

Fouten zijn JSON met een leesbare melding en een machinecode:

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

Veld	Type	Beschrijving
401	unauthorized	Token ontbreekt, is ongeldig of ingetrokken.
403	forbidden	Token geldig maar niet toegestaan.
404	not_found	Resource bestaat niet op dit account.
502	control_plane_unavailable	Gateway even onbereikbaar — probeer opnieuw.

Veelgebruikte recepten

Toon je apparaten met live status en exit-IP:

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

Roteer het IP van een apparaat en bevestig via de IP-geschiedenis:

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

Richt een proxy in voor een nieuwe klant — één credential, klaar om over te dragen:

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

Lees accountbreed verbruik voor facturatie:

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

Volledige referentie

Elk endpoint, elke parameter, elk schema en elke voorbeeldrespons staat in de interactieve console. Die rendert live vanuit hetzelfde OpenAPI-document waarop de API is gebouwd, dus hij raakt nooit verouderd.