API

Ръководство за API

Всичко, което таблото прави — сдвояване, идентификационни данни, ротация, потребление — е един REST API. Базов URL https://mobileproxy.app/api/v1. Удостоверявайте се с bearer токен.

Удостоверяване

Създайте токен в таблото под За разработчици → API токени или с POST /tokens, докато сте влезли. Тайната се показва само веднъж — запазете я. Изпращайте я при всяка заявка:

Authorization: Bearer mpx_live_…

Пробвайте на живо

Интерактивната конзола ви позволява да поставите токен и да извикате всеки endpoint от браузъра, с тела на заявки и реални отговори. Пълната спецификация е на /api/v1/openapi.json.

Грешки

Грешките са JSON с четимо съобщение и машинен код:

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

Поле	Тип	Описание
401	unauthorized	Липсващ, неправилен или отменен токен.
403	forbidden	Токенът е валиден, но няма разрешение.
404	not_found	Ресурсът не съществува в този акаунт.
502	control_plane_unavailable	Шлюзът е временно недостъпен — опитайте отново.

Често използвани рецепти

Изведете вашите устройства с активен статус и изходящ IP:

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

Завъртете IP на устройство и потвърдете от историята на 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_…"

Осигурете proxy за нов клиент — една идентификационна двойка, готова за предаване:

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

Прочетете потреблението за целия акаунт за фактуриране:

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

Пълна справка

Всеки endpoint, параметър, схема и примерен отговор е в интерактивната конзола. Тя се визуализира на живо от същия OpenAPI документ, от който е изграден API, така че никога не остарява.