Edge Functions HTTP-API-Referenz

Basis-URL. Die URL Ihres Projekts, zum Beispiel https://my-app.aurabase.cloud. Das Projekt wird vom Host identifiziert, daher tragen die unten aufgeführten Pfade keine Projekt-ID. Die Langform /v1/functions/{project_id}/… wird ebenfalls akzeptiert.

Authentifizierung. Senden Sie Ihren Schlüssel im apikey-Header. Fügen Sie Authorization: Bearer <JWT> hinzu, um als angemeldeter Benutzer anzurufen. Das Studio ruft dieselben Routen mit einem Konsolensitzungstoken auf, wodurch es die Rolle admin erhält.

Jede andere Route antwortet 403 bis anon und 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.-Körper sind JSON und benötigen Content-Type: application/json. Ein Erfolg ist { "data": …, "meta": null }. Ein Fehler ist { "error": { "code", "message", "type", "request_id" } }.

Funktionsobjekt.

Hinweise:

• POST ist ein Upsert auf name: Durch das Posten eines vorhandenen Namens wird dessen Code ersetzt. Ein env_vars-Feld in diesem Textkörper ersetzt die vorhandenen Variablen; lassen Sie es weg, um sie zu behalten.
• In PATCH wird permissions Feld für Feld zusammengeführt: { "permissions": { "timeout_secs": 60 } } behält allow_net und memory_mb. Ein Feld außerhalb seiner Grenzen gibt 400 zurück.
• PUT …/env ersetzt den gesamten Variablensatz und ist die einzige Route, die diese verschlüsselt. Siehe Geheimnisse.
• Eine Funktion mit is_active: false wird von invoke oder von Jobs nicht gefunden.

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. Rolle: anon, authenticated oder service_role.

Standardantwort, immer 200:

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

status ist der Status von Ihrer Funktion. logs ist leer für deno. Im Rohmodus ist die Antwort die eigene Ihrer Funktion: Status, content-type, Bytes plus x-aurabase-invoke-origin: function.

Auftragsobjekt: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Verhalten: Jobs, Cron und die Warteschlange für unzustellbare Nachrichten.

Eintrag: id, project_id, name, schedule (gespeichert mit 6 Feldern), function_name, payload, is_active, last_run, next_run, created_at.

Werte und Verhalten: Warnungen.