Edge Functions Informacje o interfejsie API HTTP

Podstawowy adres URL. Adres URL Twojego projektu, na przykład https://my-app.aurabase.cloud. Projekt jest identyfikowany przez hosta, więc poniższe ścieżki nie mają identyfikatora projektu. Akceptowana jest również długa forma /v1/functions/{project_id}/….

Uwierzytelnianie. Wyślij swój klucz w nagłówku apikey. Dodaj Authorization: Bearer <JWT>, aby dzwonić jako zalogowany użytkownik. Studio wywołuje te same trasy za pomocą tokena sesji konsoli, co nadaje mu rolę admin.

Każda inna trasa odpowiada 403 do anon i 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" } }

Format. Ciała są w formacie JSON i wymagają Content-Type: application/json. Sukcesem jest { "data": …, "meta": null }. Błąd to { "error": { "code", "message", "type", "request_id" } }.

Obiekt funkcyjny.

Uwagi:

• POST jest dodatkiem do name: opublikowanie istniejącej nazwy zastępuje jej kod. Pole env_vars w tej treści zastępuje istniejące zmienne; pomiń to, aby je zachować.
• W PATCH, permissions jest łączone pole po polu: { "permissions": { "timeout_secs": 60 } } zachowuje allow_net i memory_mb. Pole poza jego granicami zwraca 400.
• PUT …/env zastępuje cały zestaw zmiennych i jest jedyną trasą, która je szyfruje. Zobacz sekrety.
• Funkcja z is_active: false nie została znaleziona przez invoke ani przez zadania.

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. Rola: anon, authenticated lub service_role.

Domyślna odpowiedź, zawsze 200:

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

status to status Twojej funkcji. logs jest pusty dla deno. W trybie surowym odpowiedź jest własną funkcją: status, content-type, bajty plus x-aurabase-invoke-origin: function.

Obiekt pracy: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Zachowanie: Zadania, cron i kolejka utraconych wiadomości.

Wpis: id, project_id, name, schedule (przechowywany z 6 polami), function_name, payload, is_active, last_run, next_run, created_at.

Wartości i zachowanie: Alerty.