Edge Functions HTTP API referansı

Temel URL. Projenizin URL'si, örneğin https://my-app.aurabase.cloud. Proje, ana bilgisayar tarafından tanımlandığından aşağıdaki yollar hiçbir proje kimliği taşımamaktadır. /v1/functions/{project_id}/… uzun biçimi de kabul edilir.

Kimlik Doğrulaması. Anahtarınızı apikey başlığında gönderin. Oturum açmış kullanıcı olarak aramak için Authorization: Bearer <JWT> ekleyin. Studio aynı rotaları bir konsol oturum belirteciyle çağırır ve bu ona admin rolünü verir.

Başka herhangi bir rota 403 ile anon ve authenticated yanıtını verir:

{ "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" } }

Biçimi. Gövdeler JSON'dur ve Content-Type: application/json gerekir. Başarı { "data": …, "meta": null }. Bir başarısızlık { "error": { "code", "message", "type", "request_id" } }.

İşlev nesnesi.

Notlar:

• POST, name üzerinde bir üst öğedir: mevcut bir adın gönderilmesi, kodunun yerine geçer. Bu gövdedeki bir env_vars alanı mevcut değişkenlerin yerini alır; onları tutmak için bunu ihmal edin.
• PATCH içinde, permissions alan alan birleştirilir: { "permissions": { "timeout_secs": 60 } }, allow_net ve memory_mb tutar. Sınırlarının dışındaki bir alan 400 değerini döndürür.
• PUT …/env tüm değişken kümesinin yerine geçer ve bunları şifreleyen tek yoldur. sırlarına bakın.
• is_active: false içeren bir işlev invoke veya işler tarafından bulunamadı.

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. Rol: anon, authenticated veya service_role.

Varsayılan yanıt, her zaman 200:

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

status, işlevinizin durumudur. logs deno için boş. Ham modda yanıt, işlevinizin kendisine aittir: durum, content-type, bayt artı x-aurabase-invoke-origin: function.

İş nesnesi: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Davranış: İşler, cron ve atılacak ileti kuyruğu.

Giriş: id, project_id, name, schedule (6 alanla saklanır), function_name, payload, is_active, last_run, next_run, created_at.

Değerler ve davranış: Uyarılar.