Edge Functions Referência da API HTTP

URL base. A URL do seu projeto, por exemplo https://my-app.aurabase.cloud. O projeto é identificado pelo host, portanto os caminhos abaixo não carregam nenhum ID de projeto. O formato longo /v1/functions/{project_id}/… também é aceito.

Autenticação. Envie sua chave no cabeçalho apikey. Adicione Authorization: Bearer <JWT> para chamar como usuário conectado. O Studio chama as mesmas rotas com um token de sessão de console, que lhe confere a função admin.

Qualquer outra rota responde 403 a anon e authenticated:

{ "error": { "code": "FORBIDDEN", "type": "forbidden", "request_id": "…",
  "message": "Accès interdit : Opération réservée au rôle service_role : seule l'invocation d'une fonction est ouverte aux clés publiques" } }

Formato . Os corpos são JSON e precisam de Content-Type: application/json. Um sucesso é { "data": …, "meta": null }. Uma falha é { "error": { "code", "message", "type", "request_id" } }.

Objeto de função.

Notas:

• POST é uma atualização em name: postar um nome existente substitui seu código. Um campo env_vars nesse corpo substitui as variáveis ​​existentes; omita-o para mantê-los.
• Em PATCH, permissions é mesclado campo por campo: { "permissions": { "timeout_secs": 60 } } mantém allow_net e memory_mb. Um campo fora dos seus limites retorna 400.
• PUT …/env substitui todo o conjunto de variáveis e é a única rota que as criptografa. Consulte segredos.
• Uma função com is_active: false não é encontrada por invoke ou por jobs.

curl -X POST "$AURA_URL/v1/functions" \
  -H "apikey: $AURA_SERVICE_ROLE_KEY" -H "Content-Type: application/json" \
  -d '{"name":"hello","runtime":"deno","code":"Deno.serve(() => new Response(\"ok\"))"}'

POST /v1/functions/{name}/invoke. Função: anon, authenticated ou service_role.

Resposta padrão, sempre 200:

{ "data": { "status": 200, "headers": { "content-type": "application/json" },
  "body": { "greeting": "Hello, Ada!" }, "logs": [], "duration_ms": 74 }, "meta": null }

status é o status de sua função. logs está vazio para deno. No modo bruto, a resposta é da sua função: status, content-type, bytes, mais x-aurabase-invoke-origin: function.

Objeto de trabalho: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Comportamento: Jobs, cron e a fila de mensagens mortas.

Entrada: id, project_id, name, schedule (armazenado com 6 campos), function_name, payload, is_active, last_run, next_run, created_at.

Valores e comportamento: Alertas.