# General Translation Integrations: Paramètres de connexion
URL: https://generaltranslation.com/fr/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Référence des paramètres utilisés pour connecter un espace Storyblok à General Translation. Référence API des paramètres de connexion Storyblok.

Vous renseignez les paramètres de connexion une seule fois depuis **Projet > Intégrations > Catalogue**. General Translation les stocke dans une connexion d’organisation et les utilise pour appeler l’API de gestion de Storyblok.

## Vue d’ensemble [#overview]

| Paramètre                                | Description                             | Type                             | Facultatif | Par défaut |
| ---------------------------------------- | --------------------------------------- | -------------------------------- | ---------- | ---------- |
| [ID du espace](#space-id)                 | L’ID numérique du espace Storyblok.      | `string`                         | Non        | —          |
| [Région](#region)                        | La région où l’espace est hébergé.      | `eu` | `us` | `ca` | `ap` | `cn` | Non        | `eu`       |
| [Jeton d’accès personnel](#access-token) | Un jeton de l’API de gestion de Storyblok. | `string`                         | Non        | —          |

La connexion nécessite également de remplir les [conditions liées au plan et aux autorisations](#gating) ci-dessous.

## ID de l’espace [#space-id]

**Type** `string` · **Obligatoire**

L’ID numérique de l’espace Storyblok, affiché dans Storyblok sous **Paramètres > Général**. Il se saisit dans le champ **Space ID**, qui n’accepte que des valeurs numériques. Un `#` initial est supprimé et les espaces en début et en fin de valeur sont retirés avant l’enregistrement.

L’ID de l’espace est stocké à la fois comme identifiant de ressource de l’intégration et dans les informations d’identification. Une exécution de traduction échoue si l’ID d’espace des informations d’identification ne correspond pas à celui de l’intégration connectée.

## Région [#region]

**Type** `eu` | `us` | `ca` | `ap` | `cn` · **Obligatoire** · **Par défaut** `eu`

La région dans laquelle votre espace Storyblok est hébergé. Elle se sélectionne dans le champ **Région**, qui propose **EU**, **US**, **CA**, **AP** et **CN**. La région détermine l’URL de base de l’API de gestion de Storyblok appelée par l’intégration :

| Région | URL de base de l’API de gestion    |
| ------ | ---------------------------------- |
| `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` |

Une région non reconnue est rejetée lors de la connexion.

## Jeton d’accès personnel [#access-token]

**Type** `string` · **Obligatoire**

Un jeton d’accès personnel Storyblok (un jeton de l’API de gestion), créé dans Storyblok sous **My account > Personal access tokens**. Il est saisi dans le champ **Personal access token**, dont la valeur est masquée.

Le jeton est envoyé dans l’en-tête `Authorization` de chaque requête à l’API de gestion effectuée par l’intégration. Il doit avoir accès aux stories et aux composants de l’espace, car l’intégration lit les stories, lit et met à jour leur contenu et (pour [l’activation automatique des champs pris en charge](/docs/integrations/storyblok/guides/translating-content#auto-enable)) lit et met à jour les schémas des composants.

## Stockage [#storage]

Les informations d’identification — l’ID de l’espace, la région et le jeton d’accès personnel — sont stockées une seule fois dans une connexion d’organisation associée à l’espace Storyblok. L’intégration au projet est liée à cette connexion. L’enregistrement de la connexion est visible dans **Organization > Connexions**.

## Restrictions liées au forfait et aux permissions [#gating]

La connexion d’une intégration Storyblok nécessite les deux éléments suivants :

* **Autorisation :** `project:write` sur le projet.
* **Forfait :** Starter ou Enterprise.

Sans forfait compatible, le Dashboard affiche une invite de mise à niveau à la place du catalogue des intégrations, ce qui rend l’action **Connect** inaccessible. Sans `project:write`, l’action **Connect** n’est pas disponible. Le lancement des traductions nécessite également `translations:content:write` ainsi que la même fonctionnalité de forfait ; les actions de connexion et de traduction rejettent les requêtes provenant de forfaits non compatibles.

## Sitemap

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