Autenticação

Toda função implantada está protegida por padrão. Requisições sem uma credencial válida recebem 401 Unauthorized.

Início rápido

Implante sua função

jelou functions deploy
# ✓ Deployed
# ▸ URL: https://minha-funcao.fn.jelou.ai

O deploy não gera nenhuma credencial automaticamente. Para chamar sua função você precisa de uma API key de plataforma (veja o próximo passo).

Chame com sua API key

Crie uma API key em apps.jelou.ai, na seção de configuração do app, e envie-a no header Authorization:

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

Resposta bem-sucedida:

{ "results": [] }

Sem API key ou com uma inválida:

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

Como funciona?

Crie uma API key de plataforma em apps.jelou.ai, na seção de configuração do app
Cada requisição deve incluí-la no header Authorization: Bearer sk_...
O SDK valida a key contra o gateway da Jelou, confirma que pertence à mesma organização dona da função, e armazena o resultado em cache em memória
Se a key for válida, a requisição chega ao handler. Caso contrário, retorna 401

API keys (recomendado)

A criação de novos runtime tokens (jelou functions tokens create) está depreciada e responde 410 Gone. Os deploys também não geram um automaticamente — o mecanismo suportado para autenticar funções, novas ou existentes, é uma API key de plataforma.

Os runtime tokens jfn_rt_... criados antes desta migração continuam sendo validados com X-Jelou-Token (compatibilidade retroativa) e podem ser listados ou revogados com jelou functions tokens list / jelou functions tokens revoke, mas não podem ser criados novos nem são gerados em novos deploys.

Rotas sem autenticação

As rotas /__health e /openapi.json nunca requerem credencial. Os triggers cron também não — a plataforma os autentica automaticamente.

Exemplos de uso

curl
Node.js
Python

curl -X POST https://minha-funcao.fn.jelou.ai \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_..." \
  -d '{"telefone": "5511987654321"}'

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

import requests
import os

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

A plataforma não valida nada — seu código é responsável.

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Gestão

Marketplace

Canais

Configuração

Faturamento

Início rápido

Como funciona?

API keys (recomendado)

Rotas sem autenticação

Exemplos de uso

​Início rápido

​Como funciona?

​API keys (recomendado)

​Rotas sem autenticação

​Exemplos de uso

Início rápido

Como funciona?

API keys (recomendado)

Rotas sem autenticação

Exemplos de uso