# General Translation Integrations: Настройки подключения
URL: https://generaltranslation.com/ru/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Справочник по настройкам, используемым для подключения пространства Storyblok к General Translation. Справочник API по настройкам подключения Storyblok.

Вы указываете настройки подключения один раз в разделе **Project > Integrations > Catalog**. General Translation сохраняет их в подключении Organization и использует для вызова Storyblok Management API.

## Обзор [#overview]

| Параметр                                    | Описание                                  | Тип                              | Необязательно | По умолчанию |
| ------------------------------------------- | ----------------------------------------- | -------------------------------- | ------------- | ------------ |
| [ID пространства](#space-id)                | Числовой ID пространства Storyblok.       | `string`                         | Нет           | —            |
| [Регион](#region)                           | Регион, в котором размещено пространство. | `eu` | `us` | `ca` | `ap` | `cn` | Нет           | `eu`         |
| [Персональный токен доступа](#access-token) | Токен Storyblok Management API.           | `string`                         | Нет           | —            |

Для подключения также должны быть выполнены указанные ниже требования к [ограничению по тарифу и разрешению](#gating).

## ID пространства [#space-id]

**Тип** `string` · **Обязательно**

Числовой ID пространства Storyblok, указанный в Storyblok в разделе **Settings > General**. Он вводится в поле **Space ID**, которое принимает только числовые значения. Ведущий символ `#` удаляется, а окружающие пробелы — обрезаются перед сохранением значения.

ID пространства сохраняется как идентификатор ресурса интеграции, а также в учетных данных. Запуск перевода завершается ошибкой, если ID пространства в учетных данных не совпадает с ID подключенной интеграции.

## Регион [#region]

**Тип** `eu` | `us` | `ca` | `ap` | `cn` · **Обязательно** · **По умолчанию** `eu`

Регион, в котором размещено ваше пространство Storyblok. Выбирается в поле **Region**, где доступны значения **EU**, **US**, **CA**, **AP** и **CN**. Регион определяет, какой базовый URL Storyblok Management API использует интеграция:

| Регион | Базовый URL Management API         |
| ------ | ---------------------------------- |
| `eu`   | `https://mapi.storyblok.com/v1`    |
| `us`   | `https://api-us.storyblok.com/v1`  |
| `ca`   | `https://api-ca.storyblok.com/v1`  |
| `ap`   | `https://api-ap.storyblok.com/v1`  |
| `cn`   | `https://app.storyblokchina.cn/v1` |

При подключении нераспознанный регион будет отклонён.

## Персональный токен доступа [#access-token]

**Тип** `string` · **Обязательно**

Персональный токен доступа Storyblok (токен Management API), созданный в Storyblok в разделе **My account > Personal access tokens**. Указывается в поле **Personal access token**, значение которого скрывается.

Токен передаётся в заголовке `Authorization` при каждом запросе к Management API, который выполняет интеграция. У него должен быть доступ к stories и компонентам пространства, поскольку интеграция читает stories, читает и обновляет содержимое story, а также (для [Auto-enable supported fields](/docs/integrations/storyblok/guides/translating-content#auto-enable)) читает и обновляет схемы компонентов.

## Хранилище [#storage]

Учетные данные — ID пространства, регион и персональный токен доступа — хранятся в единственном экземпляре в подключении Organization, привязанном к пространству Storyblok. Интеграция с проектом связана с этим подключением. Запись подключения видна в разделе **Organization > Connections**.

## Ограничения по тарифу и разрешениям [#gating]

Для подключения интеграции Storyblok требуются оба условия:

* **Разрешение:** `project:write` для проекта.
* **Тариф:** Starter или Enterprise.

Без подходящего тарифа в Dashboard вместо каталога интеграций отображается предложение повысить тариф, поэтому действие **Connect** недоступно. Без `project:write` действие **Connect** также недоступно. Для запуска переводов дополнительно требуется `translations:content:write` и та же функция тарифа; действия подключения и перевода отклоняют запросы с неподдерживаемых тарифов.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.