Skip to main content
Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la documentación para desarrolladores.

Módulo Functions

Invoca funciones de backend personalizadas mediante base44.functions.

Contenido

Métodos

invoke

  • functionName: Nombre de la función de backend
  • data: Objeto opcional de parámetros (enviado como JSON, o multipart si contiene objetos File)
  • Devuelve la respuesta axios SIN PROCESAR — el JSON que devolvió tu función vive en .data, no en el objeto de nivel superior. El valor resuelto es { data, status, headers, … }.
  • Lanza en una respuesta no-2xx. El cuerpo del error está en err.response.data.

fetch

Método de bajo nivel que realiza una solicitud HTTP directa a una ruta de función de backend y devuelve el objeto Response nativo. Úsalo cuando necesites respuestas en streaming, métodos HTTP personalizados o acceso a la respuesta sin procesar.
  • path: Ruta de la función (por ejemplo, /streaming_demo o /my-function/endpoint)
  • init: Opciones de fetch nativas opcionales (RequestInit)
  • Devuelve: Objeto Response nativo

Invocar funciones

Desde el frontend

Respuesta en streaming (usando fetch)

Métodos HTTP personalizados (usando fetch)

Con subida de archivo

Con rol de servicio (backend)

Mediante REST API (curl)

Las funciones se pueden llamar mediante HTTP POST a tu dominio de app:

Escribir funciones de backend

Las funciones de backend se ejecutan en Deno. Deben exportar usando Deno.serve().

Estructura del directorio de funciones

Una función de backend es una carpeta bajo base44/functions/ con un archivo entry.ts o entry.js:
El nombre de la función es la ruta desde base44/functions/ a la carpeta que contiene entry.ts. Por ejemplo, base44/functions/process-order/entry.ts se despliega como process-order, y base44/functions/orders/process/entry.ts se despliega como orders/process. Para instrucciones completas de configuración y despliegue, consulta functions-create.md en base44-cli.

Estructura básica

Con acceso de rol de servicio

Usar secretos

Manejo de errores

Requisitos de configuración

  1. Habilita las funciones de backend en la configuración de la app (requiere plan apropiado)
  2. Crea archivos de función en base44/functions/
  3. Configura secretos mediante el panel de la app para claves API

Modos de autenticación

Dentro de la función, usa createClientFromRequest(req) para obtener un cliente que herede el contexto de autenticación del llamante.

Definiciones de tipos

Cómo obtener nombres de función tipados: La CLI de Base44 puede generar una augmentación de FunctionNameRegistry desde tu proyecto. Para saber cómo ejecutarlo, usa la habilidad base44-cli.
Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.