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 は変数セット全体を置き換え、それらを暗号化する唯一のルートです。 シークレットを参照してください。
• is_active: false を含む関数が invoke またはジョブで見つかりません。

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 は関数のステータスです。 denoの場合、 logs は空です。 raw モードでは、応答は関数独自のものになります (ステータス、 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。

値と動作: アラート。