- Konfiguráljon egy JSONC-fájlt minden szükséges szolgáltatáshoz
- Telepítse és engedélyezze a CLI-vel
- 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 abase44/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
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.
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 aconnectors 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
Aconnectors 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:- OAuth-összekötők
- Stripe
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
- Az összekötők áttekintése
- Alkalmazásfelhasználói összekötők
- SDK connectors referencia
- connectors push
- connectors pull
- connectors initiate
- deploy
- Backend-függvények
- Munkafolyamatok létrehozása
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.