> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/ru/guide/account/user-applications/creating-new-user-applications.md).
# Создание новых приложений
При настройке нового **Пользовательское приложение**, вы будете работать с несколькими ключевыми настройками, которые определяют, как ваше внешнее приложение интегрируется с платформой Navixy. Давайте рассмотрим каждый важный компонент.
Сначала нажмите на кнопку в **Приложения** список. В открывшейся форме настройки выполните следующие шаги:
{% stepper %}
{% step %}
## Настройте URL
Укажите URL вашего приложения — адрес, по которому размещено ваше приложение; он служит основой для интеграции.
{% hint style="danger" %}
* Убедитесь, что URL корректен, использует HTTPS-соединение, ведёт к надёжному ресурсу и содержит не более 1000 символов.
* Убедитесь, что на стороне приложения включен параметр iFrame, иначе вы не сможете открыть его в интерфейсе платформы.
{% endhint %}
{% endstep %}
{% step %}
## Настройте базовые параметры
Чтобы персонализировать приложение, вы можете добавить в URL различные параметры. Вы можете вручную добавить параметры в поле URL или воспользоваться одной из наших подсказок: язык, идентификатор пользователя или часовой пояс. Нажмите на подсказку параметра, чтобы добавить его в конец URL. Разверните описание ниже, чтобы узнать больше о предложенных параметрах и примерах.
Понимание предложенных URL-параметров
Navixy предлагает несколько базовых параметров для персонализации
1. `?locale={locale_code}`\
Языковой параметр, который автоматически соответствует языку платформы пользователя.
* Пример: `https://your-app.com/dashboard?locale=en`
2. `?user_id={user_identifier}`\
Параметр контекста пользователя, который передаёт идентификатор пользователя для фильтрации персонализированной информации.
* Пример: `https://your-app.com/dashboard?user_id=12345`
3. `?timezone={timezone}`\
Параметр времени, который автоматически соответствует часовому поясу платформы пользователя.
* Пример: `https://your-app.com/dashboard?timezone=UTC+1`
Вы можете изменить предложенное имя параметра или указать для него определённое значение.
{% hint style="info" %}
Протестируйте конфигурацию, чтобы убедиться, что приложение загружается корректно. Нажмите чтобы показать предварительный просмотр.
{% endhint %}
{% endstep %}
{% step %}
## Настройте внешний вид
Создайте узнаваемый образ приложения, чтобы его было легко найти. Следующие настройки помогут вам в этом:
* **Метка**: Добавьте уникальное, информативное имя для приложения (до 24 символов). Оно отображается в боковой панели платформы.
* **Описание**: Добавьте краткое пояснение с деталями о функциональности приложения или выделите важную информацию (до 50 символов). Информативное описание поможет пользователям лучше понять назначение приложения.
* **Значок**: Выберите значок, который отражает функцию приложения, для ещё более нативной навигации.
{% endstep %}
{% step %}
## Выберите способ отображения
Решите, как будет открываться ваше приложение, выбрав один из двух вариантов в **Открыть в** раскрывающемся списке:
* **Встроенный**: Приложение отображается внутри интерфейса платформы
* **Новая вкладка**: Приложение открывается в отдельной вкладке браузера
{% hint style="info" %}
Платформа Navixy использует iFrame для встраивания. Поскольку не все URL можно успешно обработать с помощью этой технологии, обязательно предварительно просмотрите результат встраивания. Если у вас возникнут проблемы с этим способом отображения, рассмотрите возможность использования **Новая вкладка**.
{% endhint %}
{% endstep %}
{% step %}
## Настройте аутентификацию (необязательно)
Настройте аутентификацию, если ваше приложение использует API платформы. В этом случае платформа будет передавать данные аутентификации непосредственно в приложение при его открытии, избавляя от необходимости реализовывать дополнительную функцию входа на стороне приложения.\
Вы можете выбрать один из двух методов аутентификации:
* **API-ключ**
* Этот метод подходит для приложений, где не требуется управление ролями или разрешениями пользователей.
* API-ключ соответствует уровню доступа владельца аккаунта. Это означает, что предоставление API-ключа обычному пользователю может дать ему доступ к **всем данным** доступным основному пользователю.\
Например, если ваше приложение работает с GPS-устройствами, к которым у пользователя есть ограниченные права или нет доступа вовсе, использование API-ключа всё равно откроет доступ ко всем GPS-устройствам основного аккаунта.
* **Сеансовый ключ**
* Этот метод рекомендуется, когда используется управление ролями.
* Передаёт в приложение текущий сеансовый ключ пользователя.
{% hint style="info" %}
Выбор **API-ключ** метода автоматически отключает **Сеансовый ключ** метод, и наоборот. Одновременно можно использовать только один метод.
{% endhint %}
Когда аутентификация включена, платформа добавляет параметр `?session_key=` к URL вашего приложения.
* Если вы выбрали **API-ключ**, значение параметра содержит этот ключ.
* Если вы остановились на **Сеансовый ключ**, значение параметра включает ключ текущего сеанса пользователя, из которого открывается приложение.
Убедитесь, что приложение умеет читать и использовать этот параметр.
{% endstep %}
{% step %}
## Сохраните новое приложение
Нажмите **Сохранить** кнопку. Ваше приложение появится в **Приложения** списке и боковой панели платформы. Включенные приложения автоматически становятся доступны пользователям аккаунта.
{% endstep %}
{% endstepper %}
Пример встроенного отображения пользовательского приложения
Краткие советы по устранению неполадок
Если приложение некорректно отображается во встроенном режиме, попробуйте:
* Открыть его в новой вкладке
* Проверить, что URL указан верно и доступен
* Проверить, что все параметры правильно отформатированы
Созданные приложения остаются полностью настраиваемыми после сохранения. Вы можете в любой момент изменить их параметры и внешний вид. Подробнее об управлении приложениями см. [Управление существующими Приложениями](/docs/user/ru/guide/account/user-applications/managing-existing-user-applications.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/user/ru/guide/account/user-applications/creating-new-user-applications.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.