Übersicht Backend-Funktionen

​

Funktionen erstellen

​

Eine Konfigurationsdatei hinzufügen

{
  "name": "sendWelcomeEmail",
  "entry": "entry.ts",
}

​

entry.ts

import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);
    const user = await base44.auth.me();

    if (!user) {
      return Response.json({ error: "Unauthorized" }, { status: 401 });
    }

    const { name } = await req.json();

    return Response.json({
      message: `Hello, ${name || user.full_name}!`,
    });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});

​

Mehrere Dateien pro Funktion

// entry.ts
import { validate } from "./validate.ts";

​

Code zwischen Funktionen teilen

• Jede Funktion kann mit einem relativen Pfad aus shared importieren.
• Verschiedene Funktionen können am Ende unterschiedliche Versionen derselben gemeinsamen Datei ausführen. Wenn du eine gemeinsame Datei änderst und nur eine Funktion deployst, wird nur die Kopie dieser Funktion aktualisiert. Die anderen behalten die alte Version, bis du sie erneut deployst. Um eine gemeinsame Änderung überall anzuwenden, führe base44 functions deploy ohne Argumente aus. Damit deployst du alle Funktionen auf einmal neu.

// base44/functions/greet/entry.ts
import { ok } from "../../shared/response.ts";

export default async function (req: Request): Promise<Response> {
  const { name } = await req.json();
  return ok({ message: `Hello, ${name}!` });
}

​

Lokal testen

​

Funktionen deployen

​

Funktionen aufrufen

​

Über das SDK

import { base44 } from "@/api/base44Client";

const response = await base44.functions.invoke("sendWelcomeEmail", {
  name: "Alice",
});

​

Über HTTP

https://<your-app-domain>/functions/<function-name>

• Webhooks: Empfang von Callbacks von externen Diensten wie Stripe oder GitHub.
• Externe Integrationen: Anderen Systemen die Interaktion mit deiner App ermöglichen.
• Testen: Funktionen direkt mit Tools wie cURL oder Postman aufrufen.

curl -X POST https://your-app.base44.app/functions/sendWelcomeEmail \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice"}'

​

Limit für Funktionsketten

• Verschiebe Code, den mehrere Funktionen brauchen, nach base44/shared/ und importiere ihn dort. Rufe dann nicht mehr eine Funktion aus einer anderen auf.
• Teile einen langen Job in einzelne Schritte auf. Lass jeden Schritt seinen Fortschritt speichern und zurückkehren. Starte den nächsten Schritt dann aus deinem Frontend oder über eine geplante Automation, nicht aus dem vorherigen Schritt.

​

Das SDK in Funktionen verwenden

• Beim Aufruf über das SDK aus deinem Frontend: Die Authentifizierung des Benutzers wird automatisch durchgereicht. Du kannst auf den aktuellen Benutzer mit base44.auth.me() zugreifen und Operationen mit seinen Berechtigungen durchführen. Für Operationen auf Admin-Ebene verwende asServiceRole.
• Beim Aufruf über direktes HTTP (cURL, Webhooks, externe Dienste): Es gibt keinen authentifizierten Benutzer, also verwende asServiceRole für alle Operationen.

​

Runtime-API

import { waitUntil, secrets } from "base44:runtime";

• waitUntil(): Hält die Funktion am Leben, um Hintergrundarbeit abzuschließen, nachdem du eine Antwort zurückgegeben hast.
• secrets: Liest die Secrets deiner App zur Laufzeit mit secrets.get().

​

Hintergrundarbeit nach dem Antworten ausführen

import { waitUntil } from "base44:runtime";

export default async function (req: Request): Promise<Response> {
  waitUntil(fetch("https://hooks.example.com/ping", { method: "POST" }));

  return Response.json({ status: "accepted" });
}

​

Secrets lesen

import { secrets } from "base44:runtime";

export default async function (req: Request): Promise<Response> {
  const apiKey = secrets.get("API_KEY");

  const res = await fetch("https://api.example.com/data", {
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  return Response.json(await res.json());
}

​

Mit Drittanbieter-APIs verbinden

​

Logs ansehen

​

TypeScript-Typen

​

Siehe auch

• Automationen: Funktionen planen oder bei Datenbankereignissen auslösen
• functions-Modul: SDK-Referenz zum Aufrufen von Funktionen
• createClientFromRequest: Einen Client in Backend-Funktionen erstellen
• functions deploy: Lokale Funktionen zu Base44 deployen
• functions pull: Deployed Funktionen in dein lokales Projekt herunterladen
• functions list: Alle deployed Funktionen auflisten
• functions delete: Deployed Funktionen löschen
• logs: Funktionslogs ansehen
• exec: Funktionen isoliert aus eigenständigen Skripten testen