> 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-соединение, ведет на надежный ресурс и содержит не более 1 000 символов.
* Убедитесь, что в самом приложении включена настройка iFrame, иначе вы не сможете открыть его в интерфейсе платформы.
{% endhint %}
{% endstep %}
{% step %}
## Настройте основные параметры
Чтобы персонализировать приложение, вы можете добавить в URL различные параметры. Вы можете вручную добавить параметры в поле URL или воспользоваться одной из наших подсказок: язык, ID пользователя или часовой пояс. Нажмите на подсказку параметра, чтобы добавить его в конец 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.