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에 대한 upsert입니다. 기존 이름을 게시하면 해당 코드가 대체됩니다. 해당 본문의 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는 함수의 상태입니다. 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.

값 및 동작: 경고.