Connecteurs partagés - Base44 Support Documentation

Un connecteur partagé connecte un compte pour toute l’application. Tous les utilisateurs de l’application partagent le même jeton OAuth. Utilisez ceci pour les comptes de service, comme publier sur un canal Slack d’entreprise, lire depuis un Google Calendar partagé ou interroger un workspace Notion partagé. Pour configurer un connecteur partagé :

Configurez un fichier JSONC pour chaque service dont vous avez besoin
Déployez et autorisez via la CLI
Utilisez dans les fonctions backend en appelant getConnection() pour les connecteurs OAuth, ou en utilisant directement l’API REST Stripe pour les paiements

Configurer

Chaque connecteur est un fichier JSONC dans le répertoire des connecteurs de votre projet. Le fichier définit le type d’intégration et les scopes dont votre application a besoin. Par défaut, le répertoire est base44/connectors/, mais vous pouvez personnaliser le chemin dans votre configuration de projet.

connectors

googlecalendar.jsonc

slack.jsonc

slackbot.jsonc

notion.jsonc

Exemple

Cet exemple configure un connecteur Google Calendar avec des scopes de lecture et de gestion d’événements :

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events",
  ],
}

Référence des champs

type

string

requis

L’identifiant de type d’intégration. Consultez le tableau des services pris en charge pour la liste complète des valeurs acceptées.Chaque type de connecteur ne peut être défini qu’une seule fois dans votre projet.

scopes

array

requis

Tableau des scopes OAuth requis pour votre intégration. Les scopes spécifiques dépendent du service externe et des opérations que votre application doit effectuer. Consultez la documentation permissions et scopes des connecteurs pour les scopes disponibles pour chaque service.

Déployer et autoriser

Déployez les connecteurs avec connectors push ou deploy. Pour télécharger les connecteurs existants depuis Base44, utilisez connectors pull. Lorsque vous poussez, la CLI gère chaque connecteur en fonction de son type :

Connecteurs OAuth : la CLI vous invite à autoriser chaque connecteur un par un. Elle suggère d’ouvrir votre navigateur automatiquement, et si vous acceptez, elle parcourt séquentiellement la page d’autorisation de chaque intégration. Une fois l’autorisation terminée, vos jetons OAuth sont stockés en toute sécurité et vous pouvez les récupérer en utilisant le SDK.
Stripe : la CLI provisionne un sandbox Stripe pour votre application et retourne une URL de réclamation pour terminer l’intégration. Aucun flux OAuth n’est nécessaire.

Utiliser dans les fonctions backend

Une fois déployé et autorisé, utilisez le connecteur dans vos fonctions backend. L’approche dépend du modèle d’auth du connecteur :

Connecteurs OAuth
Stripe

Appelez connectors.getConnection() avec le type de connecteur pour récupérer un accessToken pour effectuer des appels API authentifiés. Certains connecteurs retournent également un connectionConfig avec des paramètres supplémentaires (par exemple un sous-domaine ou un ID de compte).Cet exemple récupère une connexion Google Calendar et obtient les prochains événements :

const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");

const timeMin = new Date().toISOString();
const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${accessToken}` },
});

const events = await response.json();

Stripe n’utilise pas getConnection(). À la place, la plateforme stocke vos clés API Stripe en tant que secrets d’application lorsque vous provisionnez le connecteur. Dans vos fonctions backend, lisez STRIPE_SECRET_KEY depuis l’environnement et appelez directement l’API REST Stripe.Cet exemple crée une session Stripe Checkout et retourne l’URL de paiement :

const STRIPE_SECRET_KEY = Deno.env.get("STRIPE_SECRET_KEY");

Deno.serve(async (req) => {
  const { priceId, successUrl, cancelUrl } = await req.json();

  const response = await fetch("https://api.stripe.com/v1/checkout/sessions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${STRIPE_SECRET_KEY}`,
      "Content-Type": "application/x-www-form-urlencoded",
    },
    body: new URLSearchParams({
      "payment_method_types[]": "card",
      "line_items[0][price]": priceId,
      "line_items[0][quantity]": "1",
      mode: "payment",
      success_url: successUrl || `${req.headers.get("origin")}?success=true`,
      cancel_url: cancelUrl || `${req.headers.get("origin")}?canceled=true`,
    }),
  });

  const session = await response.json();
  return Response.json({ url: session.url });
});

Automatisations de connecteur

Les automatisations de connecteur permettent à vos fonctions backend de répondre aux événements des services connectés en temps réel. Par exemple, vous pouvez exécuter une fonction lorsqu’un nouvel e-mail arrive dans Gmail ou qu’un fichier change dans Google Drive. Configurez les automatisations de connecteur dans votre fichier function.jsonc aux côtés de vos autres automatisations. Consultez Automatisations de connecteur pour la référence complète des champs, les événements pris en charge et la documentation de la charge utile.

Voir aussi

Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.

​Configurer

​Exemple

​Référence des champs

​Déployer et autoriser

​Utiliser dans les fonctions backend

​Automatisations de connecteur

​Voir aussi

Configurer

Exemple

Référence des champs

Déployer et autoriser

Utiliser dans les fonctions backend

Automatisations de connecteur

Voir aussi