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ó backend-függvényekről lásd: Integrációk használata.
A backend-függvényekkel egyéni backend kódot futtathat biztonságos, elkülönített környezetben. Függvényekkel valósíthat meg olyan üzleti logikát, amely nem futhat a böngészőben, csatlakozhat külső API-khoz védett hitelesítő adatokkal, dolgozhat fel webhookokat, vagy bővítheti alkalmazását egyéni végpontokkal. A backend-függvények a Denón, egy modern TypeScript-futtatókörnyezeten futnak. A függvényeket a frontendből az SDK-val hívhatja, amely automatikusan kezeli a hitelesítést. Minden függvény saját HTTP-végpontot is kap webhookokhoz és külső integrációkhoz. Ha egy függvényt ütemezetten, adatváltozáskor vagy egy csatlakoztatott eszköz eseményére szeretne futtatni, adja hozzá lépésként egy munkafolyamathoz.
Vegye figyelembe a következőket:
  • A függvények egyenkénti telepítésére nem vonatkozik az 50-es korlát. Egyetlen kérés, amely a projekt összes függvényét lecseréli, továbbra is legfeljebb 50 függvényt tartalmazhat. A korlát a kérésben szereplő függvényeket számolja, nem a már telepítetteket.
  • A backend-függvények maximális futási ideje 5 perc, amely ugyanúgy érvényes, akár közvetlenül hívják a függvényt, akár egy automatizálás indítja, akár munkafolyamat-lépésként fut. Az ezt túllépő kérések leállításra kerülnek. További információ a futtatási korlátokról.

Függvények létrehozása

A backend-függvényeket TypeScript-fájlokként hozza létre a projekt functions könyvtárában. Ez alapértelmezés szerint a base44/functions/ könyvtár, de az útvonalat a projektkonfigurációban módosíthatja. Minden függvény saját alkönyvtárban található egy entry.ts vagy entry.js fájllal:
functions
<function-name>
entry.ts
A CLI a functions gyökeréhez viszonyított könyvtárútvonalat használja függvénynévként. A functions/sendWelcomeEmail/entry.ts például egy sendWelcomeEmail nevű függvényt hoz létre. A rendszerezéshez alkönyvtárakba is ágyazhatja a függvényeket. A functions/email/send/entry.ts egy email/send nevű függvényt hoz létre.

Konfigurációs fájl hozzáadása

Haladó igényekhez, például egyéni függvénynevekhez adjon hozzá egy function.jsonc fájlt:
functions
<function-name>
entry.ts
function.jsonc
A konfigurációs fájl a függvény nevét és belépési pontját határozza meg:

entry.ts

A kódfájl tartalmazza a függvény logikáját. A függvény kezel egy beérkező kérést, és egy Response objektumot ad vissza. A kezelőt alapértelmezett exportként exportálja:

Több fájl egy függvényhez

Egy függvény nem korlátozódik egyetlen entry.ts fájlra. A logikát több fájlra bonthatja a függvény könyvtárán belül, és relatív útvonalakkal importálhatja őket. A függvény könyvtárában lévő minden .js, .ts, .json és .jsonc fájl a függvénnyel együtt telepítésre kerül.
functions
process-order
entry.ts
validate.ts
types.ts
A relatív importok a telepítéskor oldódnak fel. Az olyan import, amely egy a függvénnyel együtt nem telepített fájlra mutat, például egy másik függvény könyvtárában lévő fájlra, telepítéskor hibát okoz.

Kód megosztása a függvények között

Ha kódot szeretne több függvényben újrahasználni, helyezze egy shared könyvtárba a base44/ mappán belül. Egy függvény telepítésekor a CLI vele együtt feltölti a shared könyvtárat, a szerver pedig csak azokat a megosztott fájlokat csomagolja be, amelyeket az adott függvény importál. Minden függvény a saját másolatával települ az általa használt megosztott kódból. Ez a következőket jelenti:
  • Bármely függvény importálhat a shared könyvtárból relatív útvonallal.
  • Különböző függvények ugyanannak a megosztott fájlnak különböző verzióit futtathatják. Ha módosít egy megosztott fájlt, és csak egy függvényt telepít, csak annak a függvénynek a másolata frissül. A többiek megtartják a régi verziót, amíg újra nem telepíti őket. Ha egy megosztott módosítást mindenhol érvényesíteni szeretne, futtassa a base44 functions deploy parancsot argumentumok nélkül, hogy egyszerre újratelepítse az összes függvényt.
base44
shared
response.ts
functions
greet
entry.ts
farewell
entry.ts
A relatív importok elérhetik a base44/shared/ könyvtárat, de nem léphetnek ki a base44/ könyvtárból. Ha a base44/ könyvtáron kívüli kódot szeretne használni, helyezze át a base44/shared/ könyvtárba, vagy importálja npm: vagy jsr: specifikátorral.

Helyi tesztelés

Futtassa a függvényeket helyben a base44 dev paranccsal, hogy telepítés nélkül tesztelhesse a módosításokat. A részleteket a Helyi fejlesztés oldalon találja.

Függvények telepítése

A függvényeket a functions deploy paranccsal telepítheti, vagy a deploy paranccsal egyszerre feltöltheti a projekt összes erőforrását. A functions deploy <names...> paranccsal név szerint telepíthet konkrét függvényeket, a --force kapcsolóval pedig eltávolíthatja a helyben nem található távoli függvényeket. A telepített függvények helyi projektbe való letöltéséhez használja a functions pull parancsot. Hogy mi van jelenleg telepítve, a functions list paranccsal nézheti meg.

Függvények hívása

A backend-függvényeket a frontendből az SDK-val, webhookokhoz és külső integrációkhoz pedig HTTP-n keresztül hívhatja.

Az SDK-val

A base44.functions.invoke() metódussal hívhat függvényeket a frontendből. Az SDK automatikusan kezeli a hitelesítést, és átadja a függvénynek az aktuális felhasználó hitelesítő adatait.

HTTP-n keresztül

Minden telepített függvény HTTP-végpontot kap a következő címen:
Ez a következőkhöz hasznos:
  • Webhookok: Visszahívások fogadása külső szolgáltatásoktól, például a Stripe-tól vagy a GitHubtól.
  • Külső integrációk: Más rendszerek kommunikálhatnak az alkalmazással.
  • Tesztelés: Függvények közvetlen hívása olyan eszközökkel, mint a cURL vagy a Postman.
Példa a használatra
Közvetlen HTTP-hívás (például cURL vagy webhookok) esetén nincs hitelesített felhasználói kontextus. Ilyenkor minden művelethez használja az asServiceRole lehetőséget.

Függvénylánc-korlát

Az egymást hívó függvények lánca legfeljebb hét függvény hosszú lehet, a láncot indító függvényt is beleszámítva. A nyolcadik függvény minden Base44-hívása 403-as hibával, error code: 1000 kóddal meghiúsul. Ez az entitásokhoz és integrációkhoz intézett hívásokra is vonatkozik, és a láncon belüli újrapróbálkozás ugyanígy meghiúsul. Egy függvény akkor kerül a láncba, ha egy másik függvény a base44.functions.invoke() metódussal vagy az URL-jére irányuló fetch() hívással meghívja. A korlát elkerülése:
  • A több függvény által igényelt kódot helyezze a base44/shared/ könyvtárba, és importálja, ahelyett hogy egyik függvényt a másikból hívná.
  • Bontson egy hosszú feladatot külön lépésekre. Minden lépés mentse a haladását és térjen vissza, majd a következő lépést a frontendből vagy egy ütemezett munkafolyamatból indítsa, ne az előző lépésből.

Futtatási korlátok

Egy backend-függvény minden hívása a következő korlátokon belül fut. Ezek ugyanúgy érvényesek, akár közvetlenül hívják a függvényt, akár egy automatizálás indítja, akár munkafolyamat-lépésként fut. Ha egy feladat túllépheti az 5 percet, bontsa lépésekre. Minden lépés mentse a haladását és térjen vissza. Ezután a következő lépést a frontendből vagy egy ütemezett automatizálásból indítsa.

Az SDK használata a függvényekben

A backend-függvényekben a Base44 SDK-n keresztül érheti el az alkalmazás adatait, hitelesítését és integrációit. A createClientFromRequest() segítségével hozzon létre klienst a beérkező kérésből. A hitelesítési kontextus attól függ, hogyan hívták a függvényt:
  • Ha a frontendből az SDK-val hívták: A felhasználó hitelesítése automatikusan továbbítódik. Az aktuális felhasználót a base44.auth.me() metódussal érheti el, és az ő jogosultságaival végezhet műveleteket. Ha az entitás-hozzáférési szabályok alkalmazása nélkül szeretne adatokat olvasni vagy írni, használja az asServiceRole lehetőséget.
  • Ha közvetlen HTTP-n keresztül hívták (cURL, webhookok, külső szolgáltatások): Nincs hitelesített felhasználó, ezért minden művelethez az asServiceRole lehetőséget használja.

Futtatókörnyezeti API

A Base44 beépített base44:runtime modult biztosít platformszintű segédeszközökkel a függvényekhez. Közvetlenül importálhatja, telepítés nélkül:
A modul két segédeszközt exportál:
  • waitUntil(): életben tartja a függvényt, hogy a válasz visszaadása után befejezhesse a háttérmunkát.
  • secrets: az alkalmazás titkos adatainak olvasása futásidőben a secrets.get() metódussal.

Háttérmunka futtatása a válasz után

A waitUntil() segítségével életben tarthatja a függvényt a háttérmunkához a válasz visszaadása után. Adjon át neki egy promise-t, és a függvény addig fut, amíg az a promise le nem zárul. Így gyorsan válaszolhat, és utána fejezheti be az olyan munkákat, mint a naplózás, az értesítések vagy a kimenő webhookok.
A waitUntil() ugyanazt a promise-t adja vissza, amelyet átad neki, így később ugyanabban a kezelőben összefűzheti vagy megvárhatja.
A háttérmunka a lehetőségekhez mérten fut. Nem garantált, hogy befejeződik vagy újrapróbálkozik, ezért ne támaszkodjon rá olyan kritikus műveleteknél, amelyek nem veszhetnek el.

Titkos adatok olvasása

A secrets.get() metódussal futásidőben olvashatja az alkalmazás környezeti változóit. Az értéket szövegként adja vissza, vagy undefined értéket, ha a titkos adat nincs beállítva:
A secrets.get() metódust a kezelőn belül hívja, ne a modul legfelső szintjén. A titkos adatok kérésenként oldódnak fel, így a modul betöltésekor, bármely kérés futása előtt végzett olvasás undefined értéket ad vissza. A titkos adatokat a CLI-ből a secrets set paranccsal konfigurálhatja.

Csatlakozás külső API-khoz

A backend-függvények a külső API-khoz való csatlakozás egyik módját jelentik. Ideálisak, ha teljes irányításra van szüksége a kérések felett, vagy az API-kulcsokat környezeti változóként szeretné biztonságosan tárolni. A környezeti változókat a CLI-ből a secrets set paranccsal konfigurálhatja.

Naplók megtekintése

Helyi fejlesztés közben a függvények kimenete közvetlenül a terminálban jelenik meg, a logs parancs nélkül. A telepített függvények naplóit a logs paranccsal tekintheti meg. A naplók tartalmazzák a konzolkimenetet, a hibákat és az időzítési adatokat. Szűrhet függvénynév vagy időtartomány szerint. Ha MI-kódolóügynököt használ, a base44-troubleshooter skill automatikusan lekérheti és elemezheti ezeket a naplókat.

TypeScript-típusok

Generáljon TypeScript-típusokat a függvénykonfigurációkból, hogy típusbiztonságot és automatikus kiegészítést kapjon a függvénynevekhez az SDK-kódban. További információ a dinamikus típusokról.

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.