Skip to main content
Cette page fait partie d’une compétence d’agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la documentation développeur.

​
Créer des connecteurs

Les connecteurs sont des intégrations OAuth qui permettent à votre application Base44 de se connecter à des services externes comme Google Calendar, Slack, Notion, etc. Une fois connectés, vous pouvez utiliser les tokens d’accès dans les fonctions backend pour appeler directement des API externes.

​
Concepts clés

  • Accès direct à l’API : les connecteurs fournissent des tokens d’accès OAuth bruts — vous appelez les API externes directement depuis les fonctions backend
  • Compte du builder : connecte votre compte (le créateur de l’application), pas ceux de vos utilisateurs finaux
  • Fonctions backend uniquement : les tokens ne sont accessibles que côté serveur pour des raisons de sécurité

​
Emplacement des fichiers

Créez les fichiers de connecteurs dans le répertoire base44/connectors/ (ou le répertoire spécifié par connectorsDir dans votre config.jsonc). Nommage des fichiers : {type}.jsonc ou {type}.json Exemples :
  • base44/connectors/googlecalendar.jsonc
  • base44/connectors/slack.jsonc
  • base44/connectors/notion.json

​
Schéma

Chaque fichier de connecteur doit spécifier un type et éventuellement une liste de scopes : 
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

​
Champs

ChampTypeRequisDescription
typestringOuiLe type d’intégration (exécutez npx base44 connectors list-available pour voir les options)
scopesstring[]NonScopes OAuth à demander (par défaut [])

​
Découvrir les types de connecteurs disponibles

Exécutez la commande suivante pour obtenir la liste à jour des types de connecteurs pris en charge. Remarque : stripe est aussi un type valide mais n’est pas retourné par cette commande — traitez-le comme pris en charge (voir l’exemple Stripe ci-dessous). 
npx base44 connectors list-available
Cela retourne un objet JSON avec toutes les intégrations disponibles, leurs noms d’affichage, descriptions et tous les champs de configuration de connexion requis. Exemple de sortie (tronquée) : 
{
    "integrations": [
        {
            "integration_type": "googlecalendar",
            "display_name": "Google Calendar",
            "description": "Access and manage Google Calendar events",
            "connection_config_fields": []
        },
        {
            "integration_type": "slack",
            "display_name": "Slack User",
            "description": "Send messages and interact with Slack as yourself (user integration)",
            "connection_config_fields": []
        },
        {
            "integration_type": "share_point",
            "display_name": "SharePoint",
            "description": "Manage documents, lists, sites, and collaboration content in SharePoint",
            "connection_config_fields": [
                {
                    "name": "subdomain",
                    "display_name": "SharePoint Site",
                    "description": "The name of your SharePoint site (e.g., sites/mysite)",
                    "placeholder": "sites/mysite",
                    "required": true,
                    "validation_pattern": "^[a-zA-Z0-9/_-]+$",
                    "validation_error": "Please enter a valid SharePoint site path"
                }
            ]
        }
    ]
}
Utilisez la valeur integration_type de cette sortie comme champ type dans votre fichier de connecteur. Certains connecteurs requièrent des connection_config_fields supplémentaires — consultez la sortie pour les détails.

​
Stripe (Sandbox)

// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
Note : Stripe ne nécessite pas de flux OAuth dans le navigateur. Lorsque vous poussez ce connecteur, Base44 provisionne automatiquement un compte sandbox Stripe côté serveur. Vous pouvez recevoir une URL de réclamation dans la sortie du push pour lier le sandbox à votre compte Stripe.

​
Règles et contraintes

  1. Un connecteur par type : vous ne pouvez pas avoir plusieurs connecteurs du même type (par exemple, deux connecteurs googlecalendar)
  2. Le type doit être valide : le champ type doit être un type d’intégration valide (exécutez npx base44 connectors list-available pour voir les types disponibles)
  3. Les scopes sont propres au fournisseur : chaque service a son propre format de scope — consultez la documentation du fournisseur

​
Étapes suivantes

Après la création des fichiers de connecteurs, poussez-les vers Base44 : 
npx base44 connectors push
Cela vous invite à autoriser chaque nouveau connecteur OAuth dans votre navigateur. Stripe est l’exception — il est provisionné automatiquement sans flux navigateur. Consultez connectors-push.md pour les détails. Pour récupérer les connecteurs existants de Base44 vers des fichiers locaux : 
npx base44 connectors pull
Consultez connectors-pull.md pour les détails.
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.