Passer au contenu principal
Les intégrations d’espace de travail vous permettent d’enregistrer des API externes partagées au niveau de l’espace de travail à partir d’une spécification OpenAPI. Vous importez une spécification (URL ou JSON), sélectionnez jusqu’à 30 opérations et connectez l’API une seule fois dans votre espace de travail. Toute application de cet espace de travail peut alors appeler ces opérations approuvées via base44.integrations.custom.call(), au lieu de configurer sa propre connexion. Cela fonctionne aussi bien pour les API internes que pour les API de partenaires dont votre équipe dépend.
Intégrations dans un espace de travail Base44
Ces intégrations sont conçues pour être sécurisées et fiables. Les en-têtes d’authentification sensibles sont stockés en tant que secrets chiffrés de l’espace de travail et ne sont jamais renvoyés au navigateur. À l’exécution, les appels sont relayés côté serveur avec des protections contre la falsification de requête côté serveur (SSRF), et les en-têtes de l’espace de travail ont la priorité pour que les applications ne puissent pas les remplacer. La modification d’une intégration utilise la spécification stockée plutôt que l’URL en direct, et l’enregistrement est bloqué si les en-têtes ne se chargent pas, afin que vous ne les perdiez pas par erreur.
Important :
  • L’accès aux intégrations d’espace de travail est réservé aux administrateurs et propriétaires d’espace de travail disposant d’un forfait Builder ou supérieur.
  • Tout membre de l’espace de travail peut utiliser une intégration d’espace de travail existante dans ses applications, même avec un forfait gratuit.

​
Comprendre les intégrations d’espace de travail

Une intégration d’espace de travail est une connexion partagée entre votre espace de travail et une API externe ou interne, comme un CRM, un système de support ou un backend personnalisé. Vous la définissez une seule fois dans votre espace de travail à partir d’une spécification OpenAPI ou Swagger, choisissez les opérations autorisées, et toute application compatible de cet espace peut appeler ces opérations. Cela centralise la configuration et facilite la gestion des systèmes externes sur lesquels votre équipe s’appuie. Les intégrations d’espace de travail sont utiles lorsque vous souhaitez :
  • Utiliser la même API externe ou interne sur plusieurs applications du même espace de travail.
  • Conserver les informations sensibles comme les clés d’API et les jetons en un seul endroit sécurisé, gérées en tant que secrets de l’espace de travail.
  • Limiter les endpoints disponibles afin que les applications n’appellent que des opérations approuvées, définies dans la spécification.
  • Maintenir une séparation claire avec les connecteurs OAuth en un clic, car les intégrations d’espace de travail sont gérées par l’espace de travail et pilotées par une spécification.
  • Indiquer clairement quels systèmes externes votre espace de travail utilise.

​
Créer une intégration

Créez une intégration d’espace de travail personnalisée lorsque vous souhaitez exposer une nouvelle API externe à vos applications et que cette API dispose d’une spécification OpenAPI ou Swagger. Base44 lit la spécification, vous permet de choisir les endpoints à exposer et crée une intégration réutilisable pour votre espace de travail.
Avant de commencer : assurez-vous d’avoir accès à une spécification OpenAPI ou Swagger valide pour l’API que vous voulez utiliser. Vous pouvez soit l’héberger à une URL publique, soit copier le JSON.

​
Étape 1 | Ajouter une nouvelle intégration

  1. Cliquez sur le nom de votre espace de travail en haut à gauche de votre compte.
  2. Cliquez sur Settings.
  3. Cliquez sur Integrations.
  4. Cliquez sur New Integration.
  5. Choisissez comment fournir votre spécification d’API :
    • From URL : saisissez l’URL publique de votre fichier OpenAPI ou Swagger dans le champ OpenAPI Specification URL, par exemple https://api.example.com/openapi.json.
    • Paste JSON : collez la définition JSON complète de votre spécification OpenAPI ou Swagger dans l’éditeur.
  6. Cliquez sur Continue.
Ajout d'une intégration personnalisée dans un espace de travail

​
Étape 2 | Sélectionner les endpoints à exposer

Sélectionnez jusqu’à 30 endpoints pour votre intégration. Pour sélectionner les endpoints :
  1. Examinez la liste des endpoints que Base44 détecte dans votre spécification. Vous pouvez utiliser la zone de recherche pour trouver des chemins ou des opérations spécifiques par méthode ou par nom de chemin.
  2. Cochez les cases des endpoints à exposer dans votre espace de travail.
  3. Cliquez sur Continue.
Sélection des endpoints à exposer pour votre intégration d'espace de travail

​
Étape 3 | Configurer votre intégration

Configurez les détails de votre intégration, définissez l’URL de base et ajoutez les en-têtes personnalisés requis par votre API. Les valeurs d’en-têtes sensibles restent protégées. Les en-têtes d’authentification courants tels que authorization, x-api-key, api-key, x-auth-token, x-access-token, x-secret-key, bearer, secret, password et credential sont toujours traités comme des secrets. Leurs valeurs sont stockées en tant que secrets chiffrés de l’espace de travail, jamais renvoyées au navigateur, et s’affichent comme « sensitive – delete to change » lorsque vous modifiez l’intégration. Pour configurer votre intégration :
  1. Définissez les détails de votre intégration :
    • Slug : saisissez un identifiant convivial pour l’URL de l’intégration, par exemple my-api.
    • Name : saisissez le nom d’affichage qui apparaît dans la liste des intégrations de votre espace de travail.
    • Description : décrivez ce que fait l’intégration pour que vos coéquipiers sachent quand l’utiliser.
    • Base URL : confirmez ou mettez à jour l’URL de base pour votre API.
  2. Si votre API nécessite des en-têtes à envoyer avec chaque requête, ajoutez-les dans la section Custom Headers :
    1. Cliquez sur Add Header.
    2. Saisissez le nom de l’en-tête, comme Authorization ou X-API-Key.
    3. Saisissez la valeur de l’en-tête, comme votre clé d’API ou votre jeton.
    4. Utilisez l’icône de visibilité pour masquer ou révéler la valeur de l’en-tête selon les besoins.
  3. Examinez la liste des endpoints sélectionnés au bas de la fenêtre.
  4. Cliquez sur Create Integration.
Configuration de votre intégration d'espace de travail

​
Gérer les intégrations d’espace de travail

Après avoir créé une intégration d’espace de travail, elle apparaît dans l’onglet Integrations de votre espace de travail. À partir de là, vous pouvez consulter ses détails, modifier ses paramètres ou la supprimer si vous n’en avez plus besoin.

​
Consulter les détails d’une intégration

  1. Cliquez sur le nom de votre espace de travail en haut à gauche de votre compte.
  2. Cliquez sur Settings.
  3. Cliquez sur Integrations.
  4. Affichez l’intégration à inspecter et développez les endpoints.

​
Modifier une intégration

  1. Cliquez sur le nom de votre espace de travail en haut à gauche de votre compte.
  2. Cliquez sur Settings.
  3. Cliquez sur Integrations.
  4. Cliquez sur l’icône More Actions sur la carte de l’intégration.
  5. Cliquez sur Edit.
  6. Mettez à jour les champs nécessaires et enregistrez vos modifications.
Modification d'une intégration d'espace de travail
Si vous devez exposer des endpoints supplémentaires de la même API, envisagez de créer une nouvelle intégration ou de mettre à jour l’existante selon la manière dont vous voulez que les applications l’utilisent.

​
Supprimer une intégration

  1. Cliquez sur le nom de votre espace de travail en haut à gauche de votre compte.
  2. Cliquez sur Settings.
  3. Cliquez sur Integrations.
  4. Cliquez sur l’icône More Actions sur la carte de l’intégration.
  5. Cliquez sur Delete.
  6. Cliquez de nouveau sur Delete pour confirmer que vous voulez la supprimer de l’espace de travail.
Suppression d'une intégration d'espace de travail
Important : la suppression d’une intégration d’espace de travail peut casser toute intégration au niveau de l’application qui en dépend. Veillez à examiner les applications actives avant de supprimer une intégration partagée.

​
FAQ

Cliquez sur une question ci-dessous pour en savoir plus sur les intégrations d’espace de travail.
Après avoir créé une intégration d’espace de travail, toutes les nouvelles applications que vous créez dans cet espace de travail peuvent l’utiliser.Lorsque vous créez une nouvelle application, Base44 vérifie vos intégrations d’espace de travail. Si vous mentionnez l’un de ces systèmes dans votre premier prompt, l’intégration d’espace de travail correspondante est utilisée automatiquement. Par exemple, si vous avez déjà ajouté une intégration de l’API GitHub et que vous dites « Crée une application basée sur mes tickets GitHub », Base44 utilise l’intégration GitHub configurée pour l’espace de travail sans que vous ayez besoin de la sélectionner.Vous pouvez ensuite examiner et ajuster la manière dont l’application utilise cette intégration depuis les paramètres d’intégrations de l’application.
Pour créer ou gérer des intégrations d’espace de travail, vous devez être propriétaire ou administrateur d’espace de travail sur un forfait Builder ou supérieur, avec accès à l’onglet Integrations dans les paramètres de votre espace de travail. Si vous ne voyez pas le bouton Add Integration ni les options de modification, contactez l’administrateur de votre espace de travail et demandez-lui soit de mettre à jour votre rôle, soit de créer l’intégration pour vous.
Si le propriétaire de l’API met à jour la spécification à l’URL que vous avez utilisée, les détails que Base44 en lit peuvent changer la prochaine fois que vous mettez à jour ou recréez l’intégration. Lorsque vous savez que la spécification a changé, examinez votre intégration d’espace de travail et vérifiez que les endpoints exposés correspondent toujours à ce que vos applications attendent.
Les valeurs d’en-têtes comme les clés d’API et les jetons sont stockées dans le cadre de la configuration de l’intégration d’espace de travail. Seuls les coéquipiers autorisés à gérer les intégrations d’espace de travail peuvent voir ou modifier ces valeurs. Utilisez l’icône de visibilité à l’étape Configure pour masquer les valeurs à l’écran lorsque vous travaillez dans des espaces partagés.
Oui. Vous pouvez créer plusieurs intégrations d’espace de travail qui pointent vers la même API externe. Par exemple, vous pourriez créer des intégrations distinctes pour les environnements sandbox et production, ou pour différents ensembles d’endpoints utilisés par différentes applications.
Lorsque vous devez faire pivoter une clé ou un jeton, générez d’abord le nouvel identifiant dans le système externe. Puis modifiez l’intégration d’espace de travail, mettez à jour la valeur d’en-tête concernée avec la nouvelle clé ou le nouveau jeton et enregistrez vos modifications. Une fois l’intégration d’espace de travail mise à jour, les applications qui l’utilisent commencent à envoyer la nouvelle valeur automatiquement.
Vérifiez que l’URL pointe directement vers un fichier OpenAPI ou Swagger JSON ou YAML valide et qu’elle est accessible publiquement depuis votre navigateur. Si le fichier est derrière une authentification ou servi en HTML, Base44 ne peut pas l’analyser.Si vous voyez toujours des erreurs, passez à l’option Paste JSON, copiez le JSON brut de votre spécification et réessayez.Pour un test rapide, vous pouvez aussi essayer une spécification connue valide, comme un exemple d’API publique, pour confirmer que le flux fonctionne.
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.