Ugrás a fő tartalomhoz
Ön a fejlesztői dokumentációt nézi
Ez a dokumentáció a Base44 fejlesztői platformmal dolgozó fejlesztőknek szól. Az alkalmazásszerkesztőben használható összekötőkről lásd: Összekötők használata.
A megosztott összekötő egyetlen fiókot csatlakoztat a teljes alkalmazáshoz. Minden alkalmazásfelhasználó ugyanazt az OAuth-tokent használja. Ezt szolgáltatásfiókokhoz használja, például egy céges Slack-csatornára való közzétételhez, egy megosztott Google-naptár olvasásához vagy egy megosztott Notion-munkaterület lekérdezéséhez. Megosztott összekötő beállítása:
  1. Konfiguráljon egy JSONC-fájlt minden szükséges szolgáltatáshoz
  2. Telepítse és engedélyezze a CLI-vel
  3. Használja backend-függvényekben: OAuth-összekötőknél hívja meg a getConnection() metódust, fizetésekhez pedig közvetlenül a Stripe REST API-t használja

Konfigurálás

Minden összekötő egy JSONC-fájl a projekt connectors könyvtárában. A fájl meghatározza az integráció típusát és az alkalmazáshoz szükséges hatóköröket. Alapértelmezés szerint ez a base44/connectors/ könyvtár, de az útvonalat a projektkonfigurációban módosíthatja.
connectors
googlecalendar.jsonc
slack.jsonc
slackbot.jsonc
notion.jsonc

Példa

Ez a példa egy Google Calendar-összekötőt konfigurál olvasási és eseménykezelési hatókörökkel:

Mezőreferencia

string
kötelező
Az integráció típusazonosítója. Az elfogadott értékek teljes listáját a támogatott szolgáltatások táblázatában találja.Minden összekötőtípus csak egyszer definiálható a projektben.
array
kötelező
Az integrációhoz szükséges OAuth-hatókörök tömbje. A konkrét hatókörök a külső szolgáltatástól és az alkalmazás által végzett műveletektől függenek. Az egyes szolgáltatások elérhető hatóköreit az összekötők engedélyei és hatókörei dokumentációban találja.

Telepítés és engedélyezés

Az összekötőket a connectors push vagy a deploy paranccsal telepítheti. A meglévő összekötők Base44-ből való letöltéséhez használja a connectors pull parancsot. Feltöltéskor a CLI az összekötő típusától függően kezeli az egyes összekötőket:
  • OAuth-összekötők: A CLI egyenként kéri az egyes összekötők engedélyezését. Felajánlja a böngésző automatikus megnyitását, és ha elfogadja, sorban végigmegy az egyes integrációk engedélyezési oldalain. Az engedélyezés után az OAuth-tokenek biztonságosan tárolódnak, és az SDK-val lekérheti őket.
  • Stripe: A CLI Stripe-sandboxot hoz létre az alkalmazáshoz, és egy igénylési URL-t ad vissza a bevezetés befejezéséhez. Nincs szükség OAuth-folyamatra.

Összekötő beállítása helyi projekt nélkül

A connectors push a projektből olvassa az összekötőfájlokat, ezért helyi checkoutra van szüksége. Ha helyi projekt nélkül szeretne összekötőt beállítani, például egy alkalmazásszerkesztőben épített alkalmazáson vagy egy MI-ügynökből, használja a connectors initiate parancsot. Ez közvetlenül egy célalkalmazáson állít be egy összekötőt, és elindítja annak OAuth-folyamatát, fájlok olvasása vagy írása nélkül. Ha utána az összekötő konfigurációját egy helyi projektbe szeretné hozni, futtassa a connectors pull parancsot.
A connectors initiate egyetlen összekötőt állít be, és soha nem távolít el egyet sem. A connectors push hozzáadja és frissíti a helyi fájlokban szereplő összekötőket, a --force kapcsolóval pedig a fájlokból hiányzó összekötőket is eltávolítja.

Használat backend-függvényekben

A telepítés és engedélyezés után használja az összekötőt a backend-függvényekben. A megközelítés az összekötő hitelesítési modelljétől függ:
Hívja meg a connectors.getConnection() metódust az összekötő típusával, hogy egy accessToken értéket kapjon a hitelesített API-hívásokhoz. Egyes összekötők egy connectionConfig objektumot is visszaadnak további paraméterekkel (például aldomain vagy fiókazonosító).Ez a példa lekér egy Google Calendar-kapcsolatot, és lekérdezi a közelgő eseményeket:

Összekötő-munkafolyamatok

Az összekötő-munkafolyamatokkal a backend-függvények valós időben reagálhatnak a csatlakoztatott eszközök eseményeire. Futtathat például egy függvényt, amikor új e-mail érkezik a Gmailbe, vagy egy fájl módosul a Google Drive-on. Lásd: Connector eseményindítók.

Lásd még

Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.