> 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).
# Создание новых пользовательских приложений
При настройке нового **Пользовательского приложения**, вам предстоит работать с несколькими ключевыми настройками, которые определяют, как ваше внешнее приложение интегрируется с платформой. Давайте рассмотрим каждый важный компонент.
Начните с нажатия на кнопку в **Пользовательские приложения** список. В появившейся форме настройки выполните следующие шаги:
{% stepper %}
{% step %}
**Настройте URL**
Укажите URL вашего приложения — адрес, по которому размещено ваше приложение; он служит основой для интеграции.
{% hint style="danger" %}
* Убедитесь, что URL действителен, использует соединение HTTPS, ведет к надежному ресурсу и содержит не более 1000 символов.
* Убедитесь, что на стороне приложения включена настройка iFrame, иначе вы не сможете открыть его в интерфейсе платформы.
{% endhint %}
{% endstep %}
{% step %}
**Настройте основные параметры**
Чтобы персонализировать ваше приложение, вы можете включать различные параметры в URL. Вы можете вручную добавить параметры в поле URL или воспользоваться одной из наших рекомендаций: язык, идентификатор пользователя или часовой пояс. Нажмите на предложенный параметр, чтобы добавить его в конец URL. Разверните описание ниже, чтобы узнать больше о предложенных параметрах и примерах.
Понимание предложенных параметров URL
Мы предлагаем несколько базовых параметров для персонализации
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" %}
Наша платформа использует iFrame для встраивания. Поскольку не все URL могут быть успешно обработаны с помощью этой технологии, обязательно предварительно просмотрите результат встраивания. Если у вас возникнут какие-либо проблемы с этим способом отображения, рассмотрите возможность использования **Новая вкладка**.
{% endhint %}
{% endstep %}
{% step %}
**Настройте аутентификацию (необязательно)**
Настройте аутентификацию, если ваше приложение использует API платформы. В этом случае платформа будет передавать данные аутентификации непосредственно в приложение при его открытии, избавляя вас от необходимости реализовывать дополнительную функцию входа на стороне приложения.\
Вы можете выбрать один из двух методов аутентификации:
* **поле «Ключ API»**
* Этот метод предназначен для приложений, где не требуется управление ролями или правами пользователей.
* API-ключ соответствует уровню доступа владельца учетной записи. Это означает, что предоставление обычному пользователю API-ключа может предоставить ему доступ к **всем данным** доступным основному пользователю.\
Например, если ваше приложение работает с трекерами, к которым у пользователя есть ограниченные права или вовсе нет доступа, использование API-ключа все равно откроет все трекеры из основной учетной записи.
* **Сессионный ключ**
* Этот метод рекомендуется, если требуется управление ролями.
* Передает в приложение текущий сессионный ключ пользователя.
{% 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.