> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Мобильный 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/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет. [Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md) [Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md) [Локальная мобильная настройка](https://supastack.dev/ru/docs/mobile/ship-in-5-minutes.md) [Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md) ## Понимание собственной области действия Expo включает встроенную аутентификацию/сеанс и глубокие ссылки наряду с рабочей областью, настройками, чатом и поверхностями покупок RevenueCat. Общее деловое поведение и авторизация остаются в веб-сервере/пакетах; Собственные клиенты под `apps/mobile/src` вызывают эти API без внедрения учетных данных поставщика. ## Используйте BFF с аутентификацией по сеансу. Маршруты `/api/mobile` охватывают права, доступность покупок RevenueCat и синхронизацию сервера, организацию, участников, приглашения, аудит, ключи API, веб-перехватчики, домены, расписания и запросы функций. Они сохраняют владение рабочим пространством и проверки ролей. Они отличаются от публичного контракта `sk_` с ключом на предъявителя `/api/v1`. Используйте доступный вашему устройству `EXPO_PUBLIC_API_URL` и настроенный источник/схему; общедоступные переменные Expo никогда не содержат учетные данные поставщика. ## Проверка на собственных целях Проверьте состояния загрузки/ошибки/пустоты, повторное подключение, срок действия сеанса, запрещенные действия управления и возвраты глубоких ссылок на устройстве/сборке, которую вы собираетесь поддерживать. Экспорт Expo подтверждает комплектацию, а не собственную доставку или принятие покупки. [Все маршруты API](https://supastack.dev/ru/docs/web/project-structure.md) [Собственный поток сеанса](https://supastack.dev/ru/docs/mobile/authentication.md) ## Настройка и конфигурация Приложение вызывает 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 и недействительную сессию как разные состояния — одно повторяет попытку, другое возвращает ко входу. Держите полезные нагрузки идентичными веб-контракту: сервер применяет те же правила пространства, энтайтлмента и валидации независимо от того, какой клиент вызвал. ## Проверка и устранение неполадок Тестируйте сбои в авиарежиме, истёкшие в середине сессии токены, отозванные сессии и холодный старт с сохранённым валидным токеном. Запрос, который завершается закрыто (отказом), корректен; завершающийся открыто — баг, который нужно исправить до релиза. ## Вперёд [Нативный UI и темы](https://supastack.dev/ru/docs/mobile/ui.md)