API

Ghid API

Tot ce face dashboard-ul — pairing, credențiale, rotation, utilizare — este un singur API REST. URL de bază https://mobileproxy.app/api/v1. Autentificați-vă cu un bearer token.

Autentificare

Creați un token în dashboard, la Pentru dezvoltatori → Tokenuri API, sau cu POST /tokens în timp ce sunteți autentificat. Secretul este afișat o singură dată — salvați-l. Trimiteți-l la fiecare cerere:

Authorization: Bearer mpx_live_…

Încercați live

Consola interactivă vă permite să lipiți un token și să apelați fiecare endpoint din browser, cu corpuri de cerere și răspunsuri reale. Specificația completă se află la /api/v1/openapi.json.

Erori

Erorile sunt în format JSON, cu un mesaj lizibil și un cod pentru mașini:

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

Câmp	Tip	Descriere
401	unauthorized	Token lipsă, malformat sau revocat.
403	forbidden	Token valid, dar fără permisiune.
404	not_found	Resursa nu există în acest cont.
502	control_plane_unavailable	Gateway temporar inaccesibil — reîncercați.

Rețete uzuale

Listați dispozitivele cu status live și IP de ieșire:

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

Rotiți IP-ul unui dispozitiv și confirmați din istoricul 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_…"

Furnizați un proxy pentru un client nou — o credențială, gata de predat:

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

Citiți utilizarea la nivel de cont pentru facturare:

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

Referință completă

Fiecare endpoint, parametru, schemă și exemplu de răspuns se află în consola interactivă. Se randează live din același document OpenAPI din care este construit API-ul, așa că nu se învechește niciodată.