For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/mobile/api.md (or send Accept: text/markdown).
Мобильный API
Как приложение общается с сервером — сессии, доступность и полезные нагрузки.
Прохождение для начинающих
Предварительные требования: прочтите два руководства для начинающих ниже и завершите локальную настройку мобильного устройства. Поместите значения Expo в apps/mobile/.env.local; установите EXPO_PUBLIC_API_URL в качестве внутреннего хоста, к которому может подключиться ваше устройство. Оформление заказа только для мобильных устройств не имеет веб-сервера, поэтому запустите или подключите его отдельно. Успешный экспорт Expo подтверждает наличие пакета JavaScript, а не принятие устройства или покупки.
Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы.
1. В apps/mobile/.env.local установите EXPO_PUBLIC_API_URL на работающий внутренний адрес, доступный с вашего телефона; не используйте localhost с физического устройства.
2. Выполните локальную настройку мобильного устройства, чтобы запустить Expo, войдите в систему и откройте рабочее пространство, настройки и экраны чата.
3. Ожидайте аутентифицированные данные из той же рабочей области. Если время ожидания запроса истекло, проверьте телефонную и компьютерную сеть и запустите серверную часть отдельно при оформлении заказа только для мобильных устройств.
Для пользовательского кода начните с предоставленного prompts/README.md и скопируйте ближайшее приглашение: prompts/new-app-screen.md для экрана приложения или prompts/new-landing-page.md для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать AGENTS.md, .ai/PROJECT_CONTEXT.md и соответствующие зеркала .ai/; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.
Понимание собственной области действия
Expo включает встроенную аутентификацию/сеанс и глубокие ссылки наряду с рабочей областью, настройками, чатом и поверхностями покупок RevenueCat. Общее деловое поведение и авторизация остаются в веб-сервере/пакетах; Собственные клиенты под apps/mobile/src вызывают эти API без внедрения учетных данных поставщика.
Используйте BFF с аутентификацией по сеансу.
Маршруты /api/mobile охватывают права, доступность покупок RevenueCat и синхронизацию сервера, организацию, участников, приглашения, аудит, ключи API, веб-перехватчики, домены, расписания и запросы функций. Они сохраняют владение рабочим пространством и проверки ролей. Они отличаются от публичного контракта sk_ с ключом на предъявителя /api/v1.
Используйте доступный вашему устройству EXPO_PUBLIC_API_URL и настроенный источник/схему; общедоступные переменные Expo никогда не содержат учетные данные поставщика.
Проверка на собственных целях
Проверьте состояния загрузки/ошибки/пустоты, повторное подключение, срок действия сеанса, запрещенные действия управления и возвраты глубоких ссылок на устройстве/сборке, которую вы собираетесь поддерживать. Экспорт Expo подтверждает комплектацию, а не собственную доставку или принятие покупки.
Настройка и конфигурация
Приложение вызывает API под /api/mobile и версионируемую поверхность /api/v1 с сессией участника вместо предположений о cookie веб-приложения. EXPO_PUBLIC_API_URL — единственный источник, который знает клиент; он публичен по дизайну и не несёт секретов.
Сессионные токены приходят из потока Better Auth Expo и хранятся в нативном безопасном хранилище — никогда в открытом AsyncStorage или встроенной конфигурации.
GET /api/mobile/entitlement # access state for the member
GET /api/mobile/organization # active workspace context
GET /api/mobile/usage # current-month AI spend, meter caps, and credit balance
GET /api/mobile/appearance # synced appearance bundle (GET/PUT)
POST /api/v1/ai-tasks # authorized work, same as web
Session: /api/auth/* (Better Auth Expo flow)
# Optional server-only token for authenticated Expo push sends:
# EXPO_ACCESS_TOKEN=Рабочий процесс внедрения
Разрешайте сохранённую сессию до первого аутентифицированного запроса, обновляйте, когда сервер сообщает об истечении, и чисто выходите при отзыве. Различайте недоступность API и недействительную сессию как разные состояния — одно повторяет попытку, другое возвращает ко входу.
Держите полезные нагрузки идентичными веб-контракту: сервер применяет те же правила пространства, энтайтлмента и валидации независимо от того, какой клиент вызвал.
Проверка и устранение неполадок
Тестируйте сбои в авиарежиме, истёкшие в середине сессии токены, отозванные сессии и холодный старт с сохранённым валидным токеном. Запрос, который завершается закрыто (отказом), корректен; завершающийся открыто — баг, который нужно исправить до релиза.