API

Gwida tal-API

Dak kollu li tagħmel id-dashboard — abbinament, kredenzjali, rotazzjoni, użu — huwa REST API wieħed. Base URL https://mobileproxy.app/api/v1. Awtentika b'bearer token.

Awtentikazzjoni

Oħloq token fid-dashboard taħt Għall-iżviluppaturi → API tokens, jew b<mono>POST /tokens</mono> waqt li tkun illoggjat. Is-sigriet jintwera darba biss — aħżnu. Ibagħtu ma kull talba:

Authorization: Bearer mpx_live_…

Ipprovah live

Il-console interattiva tħallik twaħħal token u ssejjaħ kull endpoint mill-browser, b'request bodies u risposti reali. L-ispeċifikazzjoni sħiħa tinsab fi /api/v1/openapi.json.

Żbalji

L-iżbalji huma JSON b'messaġġ għall-bniedem u kodiċi għall-magna:

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

Field	Tip	Deskrizzjoni
401	unauthorized	Token nieqes, malformat, jew revokat.
403	forbidden	Token validu iżda mhux permess.
404	not_found	Ir-riżorsa ma teżistix f'dan il-kont.
502	control_plane_unavailable	Gateway momentanjament ma jintlaħaqx — erġa' pprova.

Riċetti komuni

Elenka l-apparati tiegħek bl-istatus live u l-exit IP:

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

Irrota l-IP ta' apparat u kkonferma mill-istorja tal-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_…"

Ipprovdi proxy għal klijent ġdid — kredenzjal wieħed, lest biex tgħaddih:

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

Aqra l-użu għall-kont kollu għall-fatturazzjoni:

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

Referenza sħiħa

Kull endpoint, parametru, schema, u risposta ta' eżempju jinsabu fil-console interattiva. Din tiġi renderjata live mill-istess dokument OpenAPI li fuqu hija mibnija l-API, għalhekk qatt ma tispiċċa barra mid-data.