# General Translation Integrations: Настройки подключения
URL: https://generaltranslation.com/ru/docs/integrations/storyblok/reference/connection.mdx
---

title: Настройки подключения
description: Справочник по настройкам, используемым для подключения пространства Storyblok к General Translation. Справочник API по настройкам подключения Storyblok.

---

Настройки для подключения пространства Storyblok к General Translation. Вы указываете их один раз в диалоге **Connect** в разделе **Project > Integrations**; General Translation сохраняет их в Project и использует для вызова 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 пространства, регион и персональный токен доступа — хранятся в Project, который их подключил. Каждый Project подключает собственное пространство Storyblok; учетные данные не используются совместно разными Projects. Они хранятся, пока интеграция не будет отключена.

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

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

* **Разрешение:** `project:write` для Project.
* **Функция тарифа:** `project_integrations` в тарифном плане Project.

Если эта функция недоступна в тарифе, в Dashboard вместо каталога интеграций отображается предложение повысить тариф (с указанием требуемого плана), поэтому действие **Connect** недоступно. Без `project:write` действие **Connect** также недоступно. Ограничение `project_integrations` также распространяется на запуск переводов: действия подключения и сервера перевода возвращают ошибку "Интеграции недоступны на вашем текущем тарифе." при отсутствии этой функции.