Présentation des fonctions backend

​

Créer des fonctions

​

Ajouter un fichier de configuration

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

​

entry.ts

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

export default async function (req: Request): Promise<Response> {
  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 });
  }
}

​

Plusieurs fichiers par fonction

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

​

Partager du code entre les fonctions

• Toute fonction peut importer depuis shared avec un chemin relatif.
• Des fonctions différentes peuvent exécuter des versions différentes du même fichier partagé. Modifier un fichier partagé puis déployer une seule fonction ne met à jour que la copie de cette fonction. Les autres gardent l’ancienne version jusqu’à ce que vous les redéployiez. Pour appliquer une modification partagée partout, exécutez base44 functions deploy sans argument afin de redéployer toutes les fonctions en une fois.

// 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}!` });
}

​

Tester localement

​

Déployer les fonctions

​

Appeler les fonctions

​

Via le SDK

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

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

​

Via HTTP

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

• Webhooks : recevoir des rappels de services externes comme Stripe ou GitHub.
• Intégrations externes : permettre à d’autres systèmes d’interagir avec votre application.
• Tests : appeler les fonctions directement avec des outils comme cURL ou Postman.

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

​

Utiliser le SDK dans les fonctions

• Lorsqu’appelée via le SDK depuis votre frontend : l’authentification de l’utilisateur est passée automatiquement. Vous pouvez accéder à l’utilisateur actuel avec base44.auth.me() et effectuer des opérations avec ses permissions. Pour lire ou écrire des données sans appliquer les règles d’accès des entités, utilisez asServiceRole.
• Lorsqu’appelée via HTTP direct (cURL, webhooks, services externes) : il n’y a pas d’utilisateur authentifié, utilisez donc asServiceRole pour toutes les opérations.

​

API d’exécution

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

• waitUntil() : maintient la fonction active pour terminer un travail en arrière-plan après l’envoi d’une réponse.
• secrets : lit les secrets de votre application à l’exécution avec secrets.get().

​

Exécuter un travail en arrière-plan après la réponse

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

​

Lire les secrets

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

​

Se connecter aux API tierces

​

Voir les logs

​

Types TypeScript

​

Voir aussi

• Automatisations : planifier des fonctions ou les déclencher sur des événements de base de données
• Module functions : référence SDK pour invoquer les fonctions
• createClientFromRequest : créer un client dans les fonctions backend
• functions deploy : déployer les fonctions locales vers Base44
• functions pull : télécharger les fonctions déployées vers votre projet local
• functions list : lister toutes les fonctions déployées
• functions delete : supprimer les fonctions déployées
• logs : voir les logs des fonctions
• exec : tester les fonctions isolément à partir de scripts autonomes