> 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\&token=557f4728-dad8-455c-a92a-ddd4fcb43694)

{% 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>

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