API

Treoir API

Gach rud a dhéanann an deais — péireáil, dintiúir, rothlú, úsáid — is API REST amháin é. Bun-URL https://mobileproxy.app/api/v1. Fíordheimhnigh le token iompróra.

Fíordheimhniú

Cruthaigh token sa deais faoi D'fhorbróirí → tokens API, nó le POST /tokens agus tú sínithe isteach. Taispeántar an rún uair amháin — stóráil é. Seol é le gach iarratas:

Authorization: Bearer mpx_live_…

Bain triail as beo

Ligeann an consól idirghníomhach duit token a ghreamú agus gach críochphointe a ghlao ón mbrabhsálaí, le comhlachtaí iarratais agus fíorfhreagraí. Tá an tsonraíocht iomlán ag /api/v1/openapi.json.

Earráidí

Is JSON iad earráidí le teachtaireacht dhaonna agus cód meaisín:

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

Réimse	Cineál	Cur síos
401	unauthorized	Token ar iarraidh, míchumtha, nó cúlghairthe.
403	forbidden	Token bailí ach gan cead.
404	not_found	Níl an acmhainn ann ar an gcuntas seo.
502	control_plane_unavailable	Ní raibh an geata insroichte ar feadh tamaill — bain triail arís.

Oidis choitianta

Liostaigh do ghléasanna le stádas beo agus IP amach:

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

Rothlaigh IP gléis agus deimhnigh ó stair 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_…"

Soláthar proxy do chustaiméir nua — dintiúr amháin, réidh le tabhairt ar láimh:

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éigh úsáid ar fud an chuntais le haghaidh billeála:

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

Tagairt iomlán

Tá gach críochphointe, paraiméadar, scéimre, agus freagra samplach sa chonsól idirghníomhach. Rindreáiltear beo é ón doiciméad OpenAPI céanna óna dtógtar an API, mar sin ní théann sé as dáta riamh.