API

API-guide

Allt som dashboarden gör — parkoppling, autentiseringsuppgifter, rotation, användning — är ett REST API. Bas-URL https://mobileproxy.app/api/v1. Autentisera med en bearer-token.

Autentisering

Skapa en token i dashboarden under För utvecklare → API-tokens, eller med POST /tokens när du är inloggad. Hemligheten visas en gång — spara den. Skicka den med varje förfrågan:

Authorization: Bearer mpx_live_…

Testa live

Den interaktiva konsolen låter dig klistra in en token och anropa alla endpoints direkt från webbläsaren, med förfrågningskroppar och riktiga svar. Den fullständiga specifikationen finns på /api/v1/openapi.json.

Fel

Fel är JSON med ett läsbart meddelande och en maskinkod:

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

Fält	Typ	Beskrivning
401	unauthorized	Token saknas, är felaktig eller återkallad.
403	forbidden	Token giltig men inte tillåten.
404	not_found	Resursen finns inte på detta konto.
502	control_plane_unavailable	Gateway tillfälligt onåbar — försök igen.

Vanliga recept

Lista dina enheter med live-status och exit-IP:

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

Rotera en enhets IP och bekräfta från IP-historiken:

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

Skapa en proxy för en ny kund — en autentiseringsuppgift, redo att lämnas över:

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

Läs kontoövergripande användning för fakturering:

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

Fullständig referens

Varje endpoint, parameter, schema och exempelsvar finns i den interaktiva konsolen. Den renderas live från samma OpenAPI-dokument som API:et är byggt av, så den blir aldrig inaktuell.