Shared connectors - Base44 Support Documentation

Shared connector מחבר חשבון אחד עבור כל האפליקציה. כל משתמשי האפליקציה חולקים את אותו OAuth token. השתמש בזה עבור service accounts, כמו פרסום לערוץ Slack של חברה, קריאה מ-Google Calendar משותף, או שאילתה של workspace משותף של Notion. להגדרת shared connector:

הגדר קובץ JSONC עבור כל שירות שאתה צריך
פרוס ואשר דרך ה-CLI
השתמש בפונקציות בקאנד על ידי קריאה ל-getConnection() עבור OAuth connectors, או שימוש ב-Stripe REST API ישירות עבור תשלומים

הגדרה

כל connector הוא קובץ JSONC בתיקיית ה-connectors של הפרויקט שלך. הקובץ מגדיר את סוג האינטגרציה ואת ה-scopes שהאפליקציה שלך צריכה. כברירת מחדל התיקייה היא base44/connectors/, אבל אתה יכול להתאים את הנתיב בתצורת הפרויקט שלך.

connectors

googlecalendar.jsonc

slack.jsonc

slackbot.jsonc

notion.jsonc

דוגמה

דוגמה זו מגדירה connector של Google Calendar עם scopes של קריאה וניהול אירועים:

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

סימוכין שדות

type

string

נדרש

מזהה סוג האינטגרציה. ראה את טבלת שירותים נתמכים עבור הרשימה המלאה של ערכים מקובלים.כל סוג connector יכול להיות מוגדר רק פעם אחת בפרויקט שלך.

scopes

array

נדרש

מערך של OAuth scopes הנדרשים עבור האינטגרציה שלך. ה-scopes הספציפיים תלויים בשירות החיצוני ובאילו פעולות האפליקציה שלך צריכה לבצע. ראה את התיעוד של connector permissions and scopes עבור scopes זמינים לכל שירות.

פריסה ואישור

פרוס connectors עם connectors push או deploy. כדי להוריד connectors קיימים מ-Base44, השתמש ב-connectors pull. כאשר אתה דוחף, ה-CLI מטפל בכל connector בהתבסס על הסוג שלו:

OAuth connectors: ה-CLI מבקש ממך לאשר כל connector אחד אחד. הוא מציע לפתוח את הדפדפן שלך אוטומטית, ואם תקבל, הוא עובר דרך דף האישור של כל אינטגרציה ברצף. לאחר שהאישור מסתיים, ה-OAuth tokens שלך נשמרים באופן מאובטח ואתה יכול לאחזר אותם באמצעות ה-SDK.
Stripe: ה-CLI מקצה Stripe sandbox עבור האפליקציה שלך ומחזיר URL claim להשלמת onboarding. אין צורך בזרימת OAuth.

שימוש בפונקציות בקאנד

לאחר הפריסה והאישור, השתמש ב-connector בפונקציות הבקאנד שלך. הגישה תלויה במודל ה-auth של ה-connector:

OAuth connectors
Stripe

קרא ל-connectors.getConnection() עם סוג ה-connector כדי לאחזר accessToken לביצוע קריאות API מאומתות. חלק מה-connectors גם מחזירים connectionConfig עם פרמטרים נוספים (לדוגמה subdomain או מזהה חשבון).דוגמה זו מאחזרת חיבור Google Calendar ושולפת אירועים קרובים:

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 אינו משתמש ב-getConnection(). במקום זאת, הפלטפורמה שומרת את מפתחות ה-API של Stripe שלך כסודות אפליקציה כאשר אתה מקצה את ה-connector. בפונקציות הבקאנד שלך, קרא את STRIPE_SECRET_KEY מהסביבה וקרא ל-Stripe REST API ישירות.דוגמה זו יוצרת session של Stripe Checkout ומחזירה את URL התשלום:

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 });
});

Connector automations

Connector automations מאפשרים לפונקציות הבקאנד שלך להגיב לאירועים משירותים מחוברים בזמן אמת. לדוגמה, אתה יכול להריץ פונקציה כאשר אימייל חדש מגיע ב-Gmail או קובץ משתנה ב-Google Drive. הגדר connector automations בקובץ function.jsonc שלך לצד ה-automations האחרים שלך. ראה Connector automations לסימוכין שדות מלא, אירועים נתמכים ותיעוד payload.

ראה גם

דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.

​הגדרה

​דוגמה

​סימוכין שדות

​פריסה ואישור

​שימוש בפונקציות בקאנד

​Connector automations

​ראה גם

הגדרה

דוגמה

סימוכין שדות

פריסה ואישור

שימוש בפונקציות בקאנד

Connector automations

ראה גם