> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BookStack

> Доступ к знаниям из вашего инстанса BookStack

## Как это работает

Коннектор BookStack при настройке получает все полки, книги, главы и страницы из подключённого инстанса.
Затем коннектор каждые **10** минут получает всё, что обновилось с момента последней синхронизации.

## Настройка

### Авторизация

Вам понадобятся учётные данные API пользователя в вашем инстансе BookStack. Для этого:

**1. Создайте или выберите пользователя для подключения**

Найдите или создайте пользователя, которого хотите использовать для подключения.

* Видимость содержимого BookStack зависит от прав этого пользователя.
* У этого пользователя должна быть роль с системным разрешением «Access system API».

**2. Откройте API Tokens**

Откройте редактирование этого пользователя под аккаунтом администратора и найдите раздел «API Tokens» внизу
страницы.

![Список API-токенов BookStack](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/bookstack/BookstackApiTokenList.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=ad06231e6526a559c225fa3453ad430a)

**3. Создайте и скопируйте токен**

Нажмите кнопку «Create Token», введите название и (необязательно) срок действия токена. Затем нажмите «Сохранить».
Скопируйте показанные значения «Token ID» и «Token Secret» для раздела «Индексирование» ниже.

![Просмотр API-токена BookStack](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/bookstack/BookstackApiToken.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=ac6ce021a14815f8ffabef126d551ee2)

### Индексирование

**1. Откройте коннектор BookStack**

Откройте панель администратора и выберите коннектор **BookStack**.

**2. Введите URL и токены**

На **шаге 1** укажите базовый URL вашего инстанса BookStack вместе с **Token ID** и **Token Secret** API,
полученными на шагах раздела «Авторизация» выше:

![Шаг 1 настройки коннектора BookStack](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/bookstack/BookstackAuth.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=97fa985d31dcae12d246792f44825e50)

**3. Запустите индексацию**

Нажмите кнопку `Подключить`! Ваше содержимое будет загружаться в Yahont каждые **10** минут.

![Шаг 2 настройки коннектора BookStack](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/bookstack/BookstackIndex.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=dde1723947400018984f17deefb5cfbc)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.