Autenticación - Jelou AI Docs

Toda función desplegada está protegida por defecto. Las peticiones sin una credencial válida reciben 401 Unauthorized.

Inicio rápido

Despliega tu función

jelou functions deploy
# ✓ Deployed
# ▸ URL: https://mi-funcion.fn.jelou.ai

El deploy no genera ninguna credencial automáticamente. Para llamar tu función necesitas una API key de plataforma (ver el siguiente paso).

Llama con tu API key

Crea una API key en apps.jelou.ai, en la sección de configuración de la app, y envíala en el header Authorization:

curl -X POST https://mi-funcion.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"query": "test"}'

Respuesta exitosa:

{ "results": [] }

Sin API key o con una inválida:

{ "error": "Unauthorized", "message": "Missing or invalid auth token (use X-Jelou-Token or Authorization: Bearer)" }

¿Cómo funciona?

Crea una API key de plataforma en apps.jelou.ai, en la sección de configuración de la app
Cada petición debe incluirla en el header Authorization: Bearer sk_...
El SDK valida la key contra el gateway de Jelou, confirma que pertenece a la misma organización dueña de la función, y cachea el resultado en memoria
Si la key es válida, la petición llega a tu handler. Si no, retorna 401

API keys (recomendado)

La creación de nuevos runtime tokens (jelou functions tokens create) está deprecada y responde 410 Gone. Los deploys tampoco generan uno automáticamente — el mecanismo soportado para autenticar funciones, nuevas o existentes, es una API key de plataforma.

Los runtime tokens jfn_rt_... creados antes de esta migración se siguen validando con X-Jelou-Token (compatibilidad hacia atrás) y pueden listarse o revocarse con jelou functions tokens list / jelou functions tokens revoke, pero no pueden crearse nuevos ni se generan en deploys nuevos.

Rutas sin autenticación

Las rutas /__health y /openapi.json nunca requieren credencial. Los triggers cron tampoco — la plataforma los autentica automáticamente.

Ejemplos de uso

curl
Node.js
Python
Brain Studio (MCP)

curl -X POST https://mi-funcion.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"telefono": "593987654321"}'

const res = await fetch("https://mi-funcion.fn.jelou.ai", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": `Bearer ${process.env.JELOU_FUNCTION_API_KEY}`,
  },
  body: JSON.stringify({ telefono: "593987654321" }),
});
const data = await res.json();

import requests
import os

res = requests.post(
    "https://mi-funcion.fn.jelou.ai",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ['JELOU_FUNCTION_API_KEY']}",
    },
    json={"telefono": "593987654321"},
)
data = res.json()

Para conectar tu función como servidor MCP externo en Brain Studio:

URL: https://mi-funcion.fn.jelou.ai/mcp
Header: Authorization → Bearer sk_...

Consulta la guía de Brain Studio para instrucciones paso a paso.

La plataforma no valida nada — tu código es responsable.

​Inicio rápido

​¿Cómo funciona?

​API keys (recomendado)

​Rutas sin autenticación

​Ejemplos de uso

Inicio rápido

¿Cómo funciona?

API keys (recomendado)

Rutas sin autenticación

Ejemplos de uso