Dokumentacja API

Uwierzytelnianie i adres bazowy

Każdy endpoint znajduje się pod https://mobileproxy.app/api/v1 i wymaga tokenu bearer. Utwórz go 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_…

Tokeny zaczynające się od mpx_live_ to tokeny Twojego konta. Endpointy /device/* są wywoływane przez samą aplikację Android i uwierzytelniają się tokenem urządzenia przypisanym do konkretnego telefonu (mpxdev_…), wydawanym podczas parowania — zwykle nigdy ich nie wywołujesz.

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

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

Konto

GET /me — kim jestem? Zwraca konto oraz bieżącą liczbę subskrypcji i tokenów API.

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

# → { "id": "u_8c31f0", "email": "[email protected]",
#     "created_at": "2026-06-28T14:02:11.000Z",
#     "subscriptions": 3, "api_tokens": 2,
#     "plan": "beta", "balance": "0.00" }

Subskrypcje

Subskrypcja (id sub_…) to trwały slot, który posiadasz: jej przyjazna nazwa (name), ustawienia i proxy zachowują się nawet przy zmianie telefonu pod nią. Jej device to telefon, który ją aktualnie napędza (lub null, gdy niesparowana), i jest wymienny — wymiana zachowuje każdy endpoint proxy.

Wylistuj subskrypcje — każda z jej sparowanym urządzeniem połączonym z bieżącym statusem bramy (online = tunel proxy działa):

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

# → { "subscriptions": [ {
#     "id": "sub_760c1fc8ddab", "name": "Paris SFR",
#     "status": "active", "wifi_split": true, "created_at": "…",
#     "device": { "id": "phone_ac862619408e", "model": "Galaxy S8",
#                 "hardware_id": "352091081234567", "hardware_type": "imei",
#                 "status": "online", "exit_ip": "77.136.66.63",
#                 "carrier": "SFR", "last_seen": "…", "paired_at": "…" } } ] }

Utwórz subskrypcję (niesparowaną), a następnie sparuj lub wymień telefon. POST /subscriptions/{id}/pair zwraca PIN ważny ok. 3 minuty; wpisany w aplikacji Android wiąże telefon. Na slocie, który ma już urządzenie, jest to wymiana (mode: "swap") — stary telefon zostaje wycofany, a każde proxy zachowuje swój host:port i poświadczenia:

curl -X POST https://mobileproxy.app/api/v1/subscriptions \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" -d '{ "name": "Paris SFR" }'
# → { "id": "sub_760c1fc8ddab", "status": "unpaired", "device": null, … }

# Pair (or swap) a phone into it
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/pair \
     -H "Authorization: Bearer mpx_live_…"
# → { "subscription_id": "sub_760c1fc8ddab", "mode": "new",
#     "pairing": { "pin": "483-119-702", "expires_at": "…" }, … }

Pobierz, zaktualizuj lub anuluj pojedynczą subskrypcję. POST zmienia nazwę, dowolny opis description (maks. 200 znaków, null go czyści), preferencję wifi_split (kolejkowaną do sparowanego telefonu, stosowaną przy jego kolejnym odpytaniu ~25 s) lub shared_speed_kbps — sposób podziału prędkości urządzenia między jego proxy. -1 (zalecane) dzieli ją automatycznie: warstwa sterowania mierzy rzeczywistą prędkość urządzenia na podstawie bieżącej przepustowości (rebalans ~3 s), proxy zajęte w tym samym czasie zbiegają się do równych udziałów, a proxy działające samotnie otrzymuje pełną prędkość. Wartość > 0 dzieli w ten sam sposób ten stały łączny limit urządzenia. Wartości speed_limit_kbps dla poszczególnych proxy są zachowywane, ale nie egzekwowane, gdy któreś z tych ustawień jest włączone; 0 wyłącza współdzielenie. DELETE likwiduje urządzenie i proxy, zwalnia porty bramy oraz usuwa historię slotu — nieodwracalnie:

# Fetch one subscription
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID \
     -H "Authorization: Bearer mpx_live_…"

# Rename / describe / set Wi-Fi split / share the device's speed equally (auto)
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "name": "Paris SFR", "description": "Client X — farm slot 2", "wifi_split": true, "shared_speed_kbps": -1 }'

# Cancel (irreversible)
curl -X DELETE https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID \
     -H "Authorization: Bearer mpx_live_…"
# → { "deleted": true, "id": "sub_760c1fc8ddab" }

Proxy

Proxy to jeden endpoint jednoprotokołowy (SOCKS5 lub HTTP) na urządzeniu, z własnym uwierzytelnianiem, białą listą źródłowych IP, limitem prędkości i regułami domen. To, ile ich urządzenie może obsłużyć jednocześnie, wynika z uprawnień planu (10 w Standard, 20 w Pro) — twórz po jednym na klienta lub narzędzie i unieważniaj dowolne bez ruszania pozostałych. Utworzenie ponad limit planu zwraca 409 proxy_limit_reached.

Utwórz proxy — generuje nową nazwę użytkownika i hasło; hasło jest zwracane jawnie tylko raz, tutaj. Wybierz protocol (socks5 lub http) i opcjonalnie przekaż traffic_limit_bytes, aby od razu nadać mu twardy limit ruchu:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "protocol": "socks5", "traffic_limit_bytes": 5368709120 }'

# → { "id": "acc_5f734b9270e8", "subscription_id": "sub_760c1fc8ddab",
#     "protocol": "socks5",
#     "host": "173.249.36.102", "host_v6": "2a02:c207:2319:6018::1",
#     "port": 30000,
#     "username": "u04c770", "password": "k7Qp2mXe9wZ4",
#     "endpoint": "socks5h://u04c770:[email protected]:30000",
#     "endpoint_ipv6": "socks5h://u04c770:k7Qp2mXe9wZ4@[2a02:c207:2319:6018::1]:30000",
#     "ip_whitelist": [], "speed_limit_kbps": 0,
#     "domain_mode": "none", "domain_rules": [],
#     "status": "active", "traffic_limit_bytes": 5368709120, "bytes_used": 0,
#     "over_limit": false, "created_at": "…" }

Edytuj politykę proxy — tryb uwierzytelniania, białą listę IP, limit prędkości i reguły domen, stosowane na żywo w bramie (protocol jest stały — zamiast tego usuń i utwórz ponownie):

curl -X PATCH \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID \
  -H "Authorization: Bearer mpx_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "speed_limit_kbps": 2000,
        "domain_mode": "whitelist", "domain_rules": ["api.example.com"] }'

Wylistuj proxy — na jednym urządzeniu lub wszystkie proxy w całym koncie:

# One device
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…"

# Account-wide
curl https://mobileproxy.app/api/v1/proxies \
     -H "Authorization: Bearer mpx_live_…"
# → { "proxies": [ { …Proxy… }, … ] }

Unieważnij proxy — natychmiast zatrzymuje ten jeden nasłuch; każde inne proxy na urządzeniu działa dalej:

curl -X DELETE \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID \
  -H "Authorization: Bearer mpx_live_…"
# → { "deleted": true, "id": "acc_5f734b9270e8" }

Limity zużycia i wygasanie dla poszczególnych proxy

Nadaj dowolnemu proxy limit zużycia — idealne, gdy odsprzedajesz dostęp i rozliczasz każdego klienta według przydziału danych. Ustaw go lub zmień w dowolnym momencie (0 go czyści): przy tworzeniu, przez PATCH lub za pomocą dedykowanego endpointu poniżej. Gdy bytes_used osiągnie limit, proxy zostaje zablokowane: zachowuje swój port i poświadczenia, ale odrzuca każde żądanie, a over_limit przyjmuje wartość true. Podnieś limit powyżej zużytej ilości — albo go wyczyść — a proxy wznowi działanie natychmiast, ten sam endpoint, bez ponownej konfiguracji. Listowanie proxy zwraca też dla każdego traffic_limit_bytes, bieżące bytes_used oraz over_limit.

curl -X POST \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/limit \
  -H "Authorization: Bearer mpx_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "traffic_limit_bytes": 10737418240 }'   # 10 GB — or 0 to remove
# → { "proxy_id": "acc_5f734b9270e8", "subscription_id": "sub_760c1fc8ddab",
#     "traffic_limit_bytes": 10737418240, "over_limit": false }

Wygasanie w czasie — nadaj proxy moment expires_at (ISO 8601, w przyszłości) przy tworzeniu lub przez PATCH; null czyści oczekujące wygaśnięcie. W tym momencie proxy zostaje wycofane — trwale, w przeciwieństwie do odwracalnej blokady limitu zużycia. Aby odnowić klienta, utwórz nowe proxy (nowy port i poświadczenia). Idealne do sprzedaży przepustek dziennych/tygodniowych:

# A proxy that stops serving in 7 days
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "protocol": "socks5", "expires_at": "2026-07-13T09:00:00Z" }'

# Extend or clear it later
curl -X PATCH \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID \
  -H "Authorization: Bearer mpx_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "expires_at": "2026-07-20T09:00:00Z" }'   # or null to remove

Konfiguracje VPN (WireGuard i OpenVPN)

Zamień dowolne proxy w VPN dla całego urządzenia. Każda konfiguracja to plik WireGuard (.conf) lub OpenVPN (.ovpn), który tuneluje całe urządzenie — telefon, laptop, router — przez mobilny IP operatora tego proxy. Proxy może mieć po 1 każdego rodzaju — jedną konfigurację WireGuard i jedną OpenVPN. Konfiguracje wymagają proxy SOCKS5 + nazwa użytkownika/hasło, aby brama mogła się do niego uwierzytelnić. Utworzenie konfiguracji wymaga dodatku VPN w zamówieniu urządzenia (bez niego 403 vpn_addon_required) — istniejące konfiguracje pozostają na liście, można je pobierać i unieważniać.

# Create a WireGuard config on a proxy
curl -X POST \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/vpn-configs \
  -H "Authorization: Bearer mpx_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "wireguard", "name": "My laptop" }'
# → { "id": "vpn_9f2c1a0b7e", "kind": "wireguard", "client_ip": "10.77.0.2",
#     "config_text": "[Interface]\nPrivateKey = …\n[Peer]\n…", … }

# ...or OpenVPN
curl -X POST \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/vpn-configs \
  -H "Authorization: Bearer mpx_live_…" -H "Content-Type: application/json" \
  -d '{ "kind": "openvpn" }'

# List a proxy's configs (metadata + per-kind usage vs the 1-per-kind cap)
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/vpn-configs \
     -H "Authorization: Bearer mpx_live_…"

# Re-download the file straight to disk
curl -OJ \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/vpn-configs/vpn_9f2c1a0b7e/file \
  -H "Authorization: Bearer mpx_live_…"

# Revoke (drops the WireGuard peer / OpenVPN cert and kills any live session)
curl -X DELETE \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies/PROXY_ID/vpn-configs/vpn_9f2c1a0b7e \
  -H "Authorization: Bearer mpx_live_…"

Użyj pliku jak zwykle: wg-quick up ./mpx-9f2c1a0b.conf dla WireGuard lub zaimportuj .ovpn do dowolnego klienta OpenVPN. Cały ruch urządzenia wychodzi wtedy przez IP operatora telefonu, a rotacja IP tego proxy rotuje też wyjście VPN.

Rotacja IP

Rotacja prosi operatora o nowy IP. Działa per urządzenie — każde proxy na urządzeniu dostaje nowy IP — jest kolejkowana do telefonu i stosowana w ciągu jednego cyklu odpytywania (~25 s).

Rotuj teraz — zakolejkuj jednorazową rotację:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…"

# → { "status": "rotating", "subscription_id": "sub_760c1fc8ddab",
#     "command_id": "cmd_a41b",
#     "note": "IP rotation on mobile networks is best-effort; …" }

Rotacja do unikatowego IP — przekaż unique: true, aby rotować, dopóki wyjściowy IP nie będzie takim, którego nie odnotowano w ostatnich window_min minutach historii IP tej subskrypcji (domyślnie 60, maks. 1440), ponawiając próbę do max_attempts razy (domyślnie 3, maks. 5). Każda próba kosztuje pełny cykl rotacji (~30–90 s); odpytuj wariant GET, aby śledzić postęp. Operatorzy mogą zgodnie z prawem ponownie przydzielić ten sam IP, więc exhausted to możliwy uczciwy wynik:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "unique": true, "window_min": 60, "max_attempts": 3 }'
# → { "status": "rotating", "request_id": "rr_18d2c4", "command_id": "cmd_a41b",
#     "unique": { "window_min": 60, "max_attempts": 3 }, … }

# Poll for the outcome (active | succeeded | exhausted | superseded | expired)
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…"
# → { "request_id": "rr_18d2c4", "status": "succeeded",
#     "attempts_used": 2, "attempts_max": 3, "window_min": 60,
#     "started_ip": "77.136.66.63", "result_ip": "77.136.67.101", … }

Linki rotacyjne — tokenizowany URL, który rotuje IP tego urządzenia po pobraniu, bez nagłówka uwierzytelniania (sekretem jest token). Wklej go do dowolnego narzędzia obsługującego „rotation URL”. Listuj, twórz i unieważniaj je:

# List rotation links
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation-links \
     -H "Authorization: Bearer mpx_live_…"
# → { "rotation_links": [ { "token": "rk_9f2c81d4e7",
#       "url": "https://mobileproxy.app/rotate/rk_9f2c81d4e7", "created_at": "…" } ] }

# Create one
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation-links \
     -H "Authorization: Bearer mpx_live_…"
# → { "token": "rk_9f2c81d4e7", "url": "https://mobileproxy.app/rotate/rk_9f2c81d4e7" }

# Revoke one
curl -X DELETE https://mobileproxy.app/api/v1/rotation-links/ROTATION_TOKEN \
     -H "Authorization: Bearer mpx_live_…"
# → { "deleted": true, "token": "rk_9f2c81d4e7" }

Rotacja zaplanowana (czasowa) — ustaw interwał automatycznej rotacji w minutach (0 ją wyłącza; maks. 1440). Zapisuje się jako rotation_interval_min na urządzeniu i wysyła polecenie set_rotation_interval, które telefon stosuje przy kolejnym odpytaniu, więc sam ponawia połączenie w tym rytmie:

# Read the current settings
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation \
     -H "Authorization: Bearer mpx_live_…"
# → { "subscription_id": "sub_760c1fc8ddab", "interval_minutes": 0,
#     "airplane_seconds": 5, "stale_ip_alert_minutes": 0 }

# Rotate automatically every 15 minutes
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "interval_minutes": 15 }'
# → { "status": "set", "subscription_id": "sub_760c1fc8ddab",
#     "interval_minutes": 15, "airplane_seconds": 5,
#     "stale_ip_alert_minutes": 0, "command_id": "cmd_a41b" }

Czas trybu samolotowego — jak długo telefon utrzymuje włączony tryb samolotowy podczas każdej zmiany IP (airplane_seconds, 3–60, domyślnie 5). Niektórzy operatorzy zwalniają starą dzierżawę dopiero po dłuższym przytrzymaniu; zwiększ tę wartość, jeśli rotacje wciąż zwracają ten sam IP. Dotyczy tak samo rotacji zaplanowanych, z panelu i z API:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "airplane_seconds": 20 }'
# → { "status": "set", "subscription_id": "sub_760c1fc8ddab",
#     "interval_minutes": 15, "airplane_seconds": 20,
#     "stale_ip_alert_minutes": 0, "command_id": "cmd_b52c" }

Własny DNS — resolwery, których telefon używa do wyszukiwania domen przez proxy (do 3 literałów IP; telefon stosuje pierwszy i ponownie zestawia tunel). Pusta lista przywraca domyślny DNS operatora:

# Read
curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/dns \
     -H "Authorization: Bearer mpx_live_…"
# → { "subscription_id": "sub_760c1fc8ddab", "dns_servers": [] }

# Set (and later send [] to go back to carrier DNS)
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/dns \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "dns_servers": ["1.1.1.1", "8.8.8.8"] }'
# → { "status": "set", "subscription_id": "sub_760c1fc8ddab",
#     "dns_servers": ["1.1.1.1", "8.8.8.8"], "command_id": "cmd_c63d" }

Monitoring

Historia wyjściowych IP — ostatnie wyjściowe IP zgłoszone przez telefon, z usuniętymi duplikatami (nowy wiersz tylko wtedy, gdy IP faktycznie się zmienił). Niezawodny sposób na sprawdzenie, czy rotacja się powiodła:

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

# → { "subscription_id": "sub_760c1fc8ddab", "ip_history": [
#     { "ip": "77.136.66.63", "carrier": "SFR", "ts": "…" }, … ] }

Opcjonalne parametry zapytania: from/to (ISO 8601) ograniczają okno, limit ogranicza liczbę wpisów (domyślnie 50, maks. 500), a group=day zwraca zamiast tego dzienną liczbę zmian — przekaż tz jako swoje przesunięcie względem UTC w minutach, aby dni były grupowane w Twojej strefie czasowej. To właśnie zasila kalendarz historii IP w panelu:

# Entries for one day
curl "https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/ip-history?from=2026-07-04T22:00:00Z&to=2026-07-05T22:00:00Z&limit=500" \
     -H "Authorization: Bearer mpx_live_…"

# Per-day counts for a month (tz = minutes east of UTC, e.g. 120 for CEST)
curl "https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/ip-history?group=day&tz=120&from=2026-06-30T22:00:00Z&to=2026-07-31T22:00:00Z" \
     -H "Authorization: Bearer mpx_live_…"
# → { "subscription_id": "sub_760c1fc8ddab", "days": [
#     { "day": "2026-07-03", "changes": 9 }, { "day": "2026-07-05", "changes": 2 } ] }

Alerty IP — serwer obserwuje Twoją flotę (~co 60 s) i otwiera alert, gdy coś wymaga uwagi: stale_ip, gdy urządzenie jest online, ale jego wyjściowy IP nie zmienił się dłużej niż próg subskrypcji (ustaw stale_ip_alert_minutes na /rotation; 0 = wyłączone, 2–10080), oraz duplicate_ip, gdy dwa Twoje urządzenia zgłaszają ten sam wyjściowy IP (NAT operatora może przydzielić dwóm SIM jeden adres — rotuj jeden, aby je rozdzielić). Alerty rozwiązują się automatycznie, gdy warunek ustanie; pokazują się też w dzwonku alertów w panelu:

# Turn on stale-IP alerts: warn after 60 min without an IP change
curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "stale_ip_alert_minutes": 60 }'

# Poll open alerts (feed this to your own monitoring)
curl https://mobileproxy.app/api/v1/alerts \
     -H "Authorization: Bearer mpx_live_…"
# → { "alerts": [
#     { "id": "42", "sub_id": "sub_760c1fc8ddab", "sub_name": "Galaxy S8",
#       "kind": "stale_ip",
#       "message": "IP unchanged for 75 min (alert threshold 60 min) — still 77.136.66.44",
#       "detail": { "ip": "77.136.66.44", "age_min": 75, "threshold_min": 60 },
#       "created_at": "…", "resolved_at": null, "seen_at": null },
#     { "id": "41", "sub_id": "sub_9d8e7f6a5b4c", "sub_name": "Galaxy A32",
#       "kind": "duplicate_ip",
#       "message": "Exit IP 77.136.67.33 is also used by “Galaxy S8” — rotate one device to separate them",
#       "detail": { "ip": "77.136.67.33",
#                   "shared_with": [ { "sub_id": "sub_760c1fc8ddab", "name": "Galaxy S8" } ] },
#       "created_at": "…", "resolved_at": null, "seen_at": null } ],
#     "unseen": 2 }

# Include resolved history; filter to one subscription
curl "https://mobileproxy.app/api/v1/alerts?status=all&subscription=SUBSCRIPTION_ID" \
     -H "Authorization: Bearer mpx_live_…"

# Reset the dashboard's unseen badge (never resolves anything)
curl -X POST https://mobileproxy.app/api/v1/alerts/seen \
     -H "Authorization: Bearer mpx_live_…"
# → { "status": "ok", "marked": 2 }

Ruch dla urządzenia — bajty liczone w bramie, rozbite na poszczególne proxy. Przydatne do rozliczania klientów, którym odsprzedajesz dostęp:

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

# → { "subscription_id": "sub_760c1fc8ddab",
#     "bytes_sent": 10485760, "bytes_recv": 262144000, "bytes_total": 272629760,
#     "per_proxy": [ { "proxy_id": "acc_5f734b9270e8",
#                      "bytes_sent": 10485760, "bytes_recv": 262144000 } ] }

Dzienny podział ruchu — dzienne bajty wysłane/odebrane, z próbek o rozdzielczości minutowej przechowywanych w warstwie webowej, dzięki czemu seria przetrwa wymiany urządzeń i wycofanie proxy. data_since oznacza najstarszą próbkę — dni przed nią nie mają danych, co nie jest tym samym co zerowy ruch. Przekaż tz (Twoje przesunięcie względem UTC w minutach), aby dni były grupowane w Twojej strefie czasowej; okna do 92 dni:

curl "https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/traffic/by-day?tz=120" \
     -H "Authorization: Bearer mpx_live_…"

# → { "subscription_id": "sub_760c1fc8ddab", "tz": 120, "data_since": "…",
#     "days": [ { "day": "2026-07-06", "bytes_sent": 10485760,
#                 "bytes_recv": 262144000, "bytes_total": 272629760 } ],
#     "total": { "bytes_sent": 10485760, "bytes_recv": 262144000,
#                "bytes_total": 272629760 } }

Dzienny czas działania — dzienne sekundy aktywności/braku aktywności zwinięte z rejestru sygnałów heartbeat urządzenia (ujednolicone mimo wymian urządzeń). Mierzy żywotność sygnałów heartbeat urządzenia (rytm ~25 s, próg przerwy ~90 s), a nie sprawność tunelu od końca do końca. current to stan w tej chwili; uptime_pct obejmuje obserwowaną część każdego dnia:

curl "https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/uptime?tz=120" \
     -H "Authorization: Bearer mpx_live_…"

# → { "subscription_id": "sub_760c1fc8ddab", "tz": 120, "current": "up",
#     "data_since": "…",
#     "days": [ { "day": "2026-07-06", "up_seconds": 31547,
#                 "down_seconds": 253, "uptime_pct": 99.2 } ] }

Zużycie w skali konta — zbiorcze zestawienie ze wszystkich urządzeń:

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

# → { "subscriptions": 3, "proxies": 5,
#     "bytes_sent": 31457280, "bytes_recv": 786432000, "bytes_total": 817889280 }

SMS / OTP

Odebrane SMS — wiadomości przychodzące na SIM tego telefonu, najnowsze na górze. Przydatne do odczytywania jednorazowych kodów weryfikacyjnych (OTP) na telefonach, które posiadasz. Zależy od opcjonalnego uprawnienia aplikacji do odbioru SMS; jeśli odmówiono go na urządzeniu, lista pozostaje pusta:

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

# → { "subscription_id": "sub_760c1fc8ddab", "messages": [
#     { "id": "1042", "sender": "+15550101",
#       "body": "Your verification code is 314159",
#       "received_at": "2026-07-05T14:12:00.000Z" }, … ] }

Serwery

Lokalizacje bram — lokalizacje, z których serwowane są Twoje proxy:

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

# → { "locations": [ { "id": "eu-de-1", "host": "173.249.36.102",
#       "region": "EU · Germany (Frankfurt)", "country": "DE",
#       "protocols": ["socks5"], "pool": "mobile" } ] }

Tokeny API

Listuj, twórz i unieważniaj tokeny API. Sekret nowo utworzonego tokenu jest pokazywany raz — zapisz go od razu; nigdy nie da się go później odzyskać. Unieważnienie działa natychmiast:

# List (metadata only — never the secret)
curl https://mobileproxy.app/api/v1/tokens \
     -H "Authorization: Bearer mpx_live_…"
# → { "tokens": [ { "id": "tk_51ad", "name": "storefront",
#       "prefix": "mpx_live_9f2c", "created_at": "…", "last_used_at": "…" } ] }

# Create (secret shown once)
curl -X POST https://mobileproxy.app/api/v1/tokens \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "name": "storefront" }'
# → { "id": "tk_51ad", "name": "storefront",
#     "token": "mpx_live_9f2c81d4e7…", "prefix": "mpx_live_9f2c",
#     "scope_subscription_id": null, "readonly": false,
#     "note": "Store this token now — it will not be shown again." }

# Revoke
curl -X DELETE https://mobileproxy.app/api/v1/tokens/TOKEN_ID \
     -H "Authorization: Bearer mpx_live_…"
# → { "deleted": true, "id": "tk_51ad" }

Klucze ograniczone i tylko do odczytu

Deleguj dostęp bez udostępniania konta. Przekaż subscription_id, aby ograniczyć token do jednej subskrypcji, oraz readonly: true, aby ograniczyć go do żądań GET. Token ograniczony sięga tylko do endpointów własnych tej subskrypcji (plus /me); token tylko do odczytu jest odrzucany przy każdym zapisie. Oba to ograniczenia nałożone na Twoje konto — klucz ograniczony nigdy nie sięgnie do danych innego konta.

# A read-only key for ONE subscription — safe to hand a teammate or a monitor
curl -X POST https://mobileproxy.app/api/v1/tokens \
     -H "Authorization: Bearer mpx_live_…" \
     -H "Content-Type: application/json" \
     -d '{ "name": "customer-42",
           "subscription_id": "sub_760c1fc8ddab",
           "readonly": true }'
# → { …, "scope_subscription_id": "sub_760c1fc8ddab", "readonly": true }

# With that key: a GET on its own subscription works…
curl https://mobileproxy.app/api/v1/subscriptions/sub_760c1fc8ddab/traffic \
     -H "Authorization: Bearer mpx_live_scoped…"     # 200

# …but another subscription, the account-wide list, or any write is refused.
curl -X POST https://mobileproxy.app/api/v1/subscriptions/sub_760c1fc8ddab/change-ip \
     -H "Authorization: Bearer mpx_live_scoped…"     # 401 (read-only)