Edge Functions HTTP API-referentie

Basis-URL. De URL van uw project, bijvoorbeeld https://my-app.aurabase.cloud. Het project wordt geïdentificeerd door de host, dus de onderstaande paden hebben geen project-ID. De lange vorm /v1/functions/{project_id}/… wordt ook geaccepteerd.

Authenticatie. Stuur uw sleutel in de apikey header. Voeg Authorization: Bearer <JWT> toe om te bellen als ingelogde gebruiker. De Studio roept dezelfde routes aan met een consolesessietoken, waardoor deze de rol admin krijgt.

Elke andere route antwoordt 403 tot anon en 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" } }

Formaat. Bodies zijn JSON en hebben Content-Type: application/json nodig. Een succes is { "data": …, "meta": null }. Een fout is { "error": { "code", "message", "type", "request_id" } }.

Functieobject.

Opmerkingen:

• POST is een aanvulling op name: het plaatsen van een bestaande naam vervangt de code ervan. Een env_vars-veld in die hoofdtekst vervangt de bestaande variabelen; laat het achterwege om ze te behouden.
• In PATCH wordt permissions veld voor veld samengevoegd: { "permissions": { "timeout_secs": 60 } } behoudt allow_net en memory_mb. Een veld buiten zijn grenzen retourneert 400.
• PUT …/env vervangt de hele reeks variabelen en is de enige route die deze versleutelt. Zie geheimen.
• Een functie met is_active: false wordt niet gevonden door invoke of door jobs.

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 of service_role.

Standaardantwoord, altijd 200:

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

status is de status van uw functie. logs is leeg voor deno. In de onbewerkte modus is het antwoord het eigen antwoord van uw functie: status, content-type, bytes, plus x-aurabase-invoke-origin: function.

Taakobject: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Gedrag: Taken, cron en de wachtrij voor dode letters.

Invoer: id, project_id, name, schedule (opgeslagen met 6 velden), function_name, payload, is_active, last_run, next_run, created_at.

Waarden en gedrag: Waarschuwingen.