API

API útmutató

Minden, amit a vezérlőpult tud — párosítás, hitelesítő adatok, rotáció, felhasználás — egyetlen REST API. Alap-URL: https://mobileproxy.app/api/v1. A hitelesítés bearer tokennel történik.

Hitelesítés

Hozzon létre egy tokent a vezérlőpulton a Fejlesztőknek → API tokenek alatt, vagy a POST /tokens hívással, miközben be van jelentkezve. A titkos kulcs csak egyszer jelenik meg — mentse el. Küldje el minden kérésnél:

Authorization: Bearer mpx_live_…

Próbálja ki élőben

Az interaktív konzol lehetővé teszi, hogy beillesszen egy tokent, és a böngészőből meghívjon minden végpontot — kérés-törzsekkel és valós válaszokkal. A teljes specifikáció itt található: /api/v1/openapi.json.

Hibák

A hibák JSON formátumúak, emberi olvasásra szánt üzenettel és gépi kóddal:

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

Mező	Típus	Leírás
401	unauthorized	A token hiányzik, hibás formátumú vagy visszavonták.
403	forbidden	A token érvényes, de nincs engedélyezve.
404	not_found	Az erőforrás nem létezik ezen a fiókon.
502	control_plane_unavailable	Az átjáró rövid ideig elérhetetlen — próbálja újra.

Gyakori receptek

Listázza az eszközeit élő állapottal és kilépő IP-vel:

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

Rotálja egy eszköz IP-jét, és erősítse meg az IP-előzményekből:

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

Készítsen elő egy proxyt egy új ügyfélnek — egyetlen hitelesítő adat, átadásra készen:

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

Olvassa ki a fiókszintű felhasználást a számlázáshoz:

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

Teljes hivatkozás

Minden végpont, paraméter, séma és példaválasz az interaktív konzolban található. Ugyanabból az OpenAPI-dokumentumból jelenik meg élőben, amelyből az API is épül, így soha nem avul el.