API

Przewodnik po API

Wszystko, co robi panel — parowanie, poświadczenia, rotacja, zużycie — to jedno REST API. Bazowy adres URL to https://mobileproxy.app/api/v1. Uwierzytelniaj się tokenem bearer.

Uwierzytelnianie

Utwórz token w panelu w sekcji Dla programistów → Tokeny API lub przez POST /tokens, będąc zalogowanym. Sekret jest pokazywany tylko raz — zapisz go. Wysyłaj go przy każdym żądaniu:

Authorization: Bearer mpx_live_…

Wypróbuj na żywo

Interaktywna konsola pozwala wkleić token i wywołać każdy endpoint z poziomu przeglądarki, wraz z treścią żądań i rzeczywistymi odpowiedziami. Pełna specyfikacja znajduje się pod adresem /api/v1/openapi.json.

Błędy

Błędy mają postać JSON z komunikatem dla człowieka i kodem maszynowym:

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

Pole	Typ	Opis
401	unauthorized	Brakujący, nieprawidłowy lub unieważniony token.
403	forbidden	Token prawidłowy, ale bez uprawnień.
404	not_found	Zasób nie istnieje na tym koncie.
502	control_plane_unavailable	Brama chwilowo nieosiągalna — ponów próbę.

Typowe przepisy

Wylistuj swoje urządzenia z bieżącym statusem i wyjściowym IP:

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

Zmień IP urządzenia i potwierdź w historii IP:

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

Udostępnij proxy nowemu klientowi — jedno poświadczenie gotowe do przekazania:

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

Odczytaj zużycie w skali konta na potrzeby rozliczeń:

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

Pełna dokumentacja

Każdy endpoint, parametr, schemat i przykładowa odpowiedź znajdują się w interaktywnej konsoli. Renderuje się ona na żywo z tego samego dokumentu OpenAPI, na którym zbudowane jest API, więc nigdy się nie dezaktualizuje.