> 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, указав URL интеграции и другие параметры для подключения внешнего инструмента к интерфейсу платформы.

При настройке нового **Пользовательское приложение**, вы будете работать с несколькими ключевыми настройками, которые определяют, как ваше внешнее приложение интегрируется с платформой Navixy. Давайте рассмотрим каждый важный компонент.

Начните с нажатия на <img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b205ed1cd11ae77328c30a95f8af7d8d5be21be8%2Fchrome_py0qhiu5p8.webp?alt=media" alt="chrome_py0qhiu5p8.webp" data-size="line"> кнопку в **Приложения** список. В открывшейся форме настройки выполните следующие шаги:

{% stepper %}
{% step %}

## Настройте URL

Укажите URL вашего приложения — адрес, по которому размещено ваше приложение; он служит основой для интеграции.

{% hint style="danger" %}

* Убедитесь, что URL корректен, использует HTTPS-соединение, ведёт на надёжный ресурс и содержит не более 1 000 символов.
* Убедитесь, что на стороне приложения включён параметр iFrame, иначе вы не сможете открыть его в интерфейсе платформы.
  {% endhint %}
  {% endstep %}

{% step %}

## Настройте основные параметры

Чтобы персонализировать ваше приложение, вы можете добавить в URL различные параметры. Вы можете вручную добавить параметры в поле URL или воспользоваться одной из наших подсказок: язык, идентификатор пользователя или часовой пояс. Нажмите на предложенный параметр, чтобы добавить его в конец URL. Разверните описание ниже, чтобы узнать больше о предложенных параметрах и примерах.

<details>

<summary>Понимание предложенных параметров URL</summary>

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`

Вы можете изменить название предложенного параметра или указать для него определённое значение.

</details>

![Пример URL приложения с параметрами](https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5ef1c1516fcc65f19333029d0918f4a42d1a5605%2FURL_with_Params.png?alt=media)

{% hint style="info" %}
Проверьте настройки, чтобы убедиться, что приложение загружается корректно. Нажмите <img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-78171811e50248dd9b883328ca7b69ec6cf767bf%2Fimage-20241217-083119.png?alt=media" alt="image-20241217-083119.png" data-size="line"> чтобы отобразить предварительный просмотр.
{% 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 %}

<figure><img src="https://2388694493-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-f3208949947b9860b2bd4665a35ccfa6708d32bb%2Fimage.png?alt=media" alt=""><figcaption><p>Пример отображения встроенного пользовательского приложения</p></figcaption></figure>

<details>

<summary>Краткие советы по устранению неполадок</summary>

Если ваше приложение отображается некорректно при встраивании, попробуйте:

* Открыть его в новой вкладке
* Проверить, что ваш URL корректен и доступен
* Проверить, что все параметры оформлены правильно

</details>

Созданные приложения остаются полностью настраиваемыми после сохранения. Вы можете в любой момент изменять их параметры и внешний вид. Подробнее об управлении приложениями см. [Управление существующими Приложениями](/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/ru/guide/account/user-applications/creating-new-user-applications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.