Mobile API — обзор (ASK Mobile)

Обновлено: 09 Октябрь 2026 Версия: 2.4.0

Краткий указатель API для ASK Mobile и интеграторов. Не дублирует Token API сотрудников из руководства пользователя API.

Важно: Mobile API использует opaque Bearer-токены (Authorization: Bearer … после /api/v1/mobile/auth/login/; access/refresh — непрозрачные строки сессии, не JWT), а не классический Authorization: Token DRF из legacy API-гайдов.

Пользовательское описание приложения: ASK Mobile.
Контракт Event Center wire v2: event-center-mobile-contract-v2.
Ops cutover: runbook-mobile-contract-v2.

Bootstrap и discovery

Endpoint	Назначение
`GET /api/v1/mobile/bootstrap/`	Capabilities, `event_center_version`, блок `push` (enabled, preferred provider, relay_url, VAPID gateway…)
`GET /.well-known/ask-mobile`	Публичный discovery (без полной auth-сессии)
`GET /api/v1/mobile/attention-summary/`	Сводка внимания (чат vs Event Center)

Auth / сессии

Префикс: /api/v1/mobile/auth/

login/, mfa/challenge/, refresh/, logout/
sessions/, sessions/{id}/

Устройство и push

GET|POST /api/v1/mobile/devices/
…/devices/{id}/
…/devices/{id}/push-registration/ и …/confirm/
…/devices/{id}/notification-settings/
Личные notification-settings/, policy/
Доставка на устройство — через Legarus Push Gateway при MOBILE_PUSH_ENABLED (admin: куда приходят уведомления)

Web-session

POST /api/v1/mobile/web-session/ — краткоживущая авторизованная сессия для открытия WEB-URL объекта из приложения (например, «Открыть» на карточке Event Center).

Tasks (MVP)

Префикс: /api/v1/mobile/tasks/ — список/создание, sync, detail, transition, comments, attachments, mark-read.

Event Center

Префикс: /api/v1/event-center/ — Inbox, counters, sync, search, execute actions.
Клиент с event_center_version ≥ 2 шлёт заголовок X-ASK-EC-Contract: 2 (см. contract v2).

Communications

Префикс: /api/v1/communications/ — conversations, messages, channels, role-branches, attention, sync.
Канон поведения (ветки, hub, mute/hide) — код communications/ и user-manual 3.12.

Связанные документы

Оглавление API
Техническое описание решения — общее DRF; Mobile/EC смотрите здесь и в contract v2