Edge Functions HTTP API 参考

基本 URL。 您项目的 URL，例如 https://my-app.aurabase.cloud。该项目由主机标​​识，因此下面的路径不包含项目 ID。长形式 /v1/functions/{project_id}/… 也被接受。

身份验证。 在 apikey 标头中发送您的密钥。添加 Authorization: Bearer <JWT> 以作为登录用户进行调用。 Studio 使用控制台会话令牌调用相同的路由，这赋予它 admin 角色。

任何其他路线都会回答 403 到 anon 和 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" } }

格式。 主体是 JSON，需要 Content-Type: application/json。成功是 { "data": …, "meta": null }。失败是 { "error": { "code", "message", "type", "request_id" } }。

函数对象。

注意事项：

• POST 是对 name的更新插入：发布现有名称替换其代码。该主体中的 env_vars 字段替换现有变量；省略它以保留它们。
• 在 PATCH中， permissions 逐个字段合并： { "permissions": { "timeout_secs": 60 } } 保留 allow_net 和 memory_mb。超出其范围的字段将返回 400。
• PUT …/env 替换整个变量集，并且是加密它们的唯一途径。请参阅 秘密。
• invoke 或作业找不到带有 is_active: false 的函数。

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。角色： anon、 authenticated 或 service_role。

默认响应，始终为 200：

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

status 是您的函数的状态。 logs 对于 deno为空。在原始模式下，响应是您的函数自己的：状态、 content-type、字节以及 x-aurabase-invoke-origin: function。

作业对象： id、 project_id、 function_name、 payload、 status （pending、 running、 completed、 failed、 dead）、 attempts、 max_attempts、 error、 scheduled_at、 started_at、 completed_at、 created_at。行为： 作业、cron 和死信队列。

条目： id、 project_id、 name、 schedule （存储 6 个字段）、 function_name、 payload、 is_active、 last_run、 next_run、 created_at。

值和行为： 警报。