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

Краткий указатель 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

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