Edge Functions Riferimento API HTTP

URL di base. L'URL del tuo progetto, ad esempio https://my-app.aurabase.cloud. Il progetto è identificato dall'host, quindi i percorsi seguenti non riportano un ID progetto. È accettata anche la forma lunga /v1/functions/{project_id}/….

Autenticazione. Invia la tua chiave nell'intestazione apikey. Aggiungi Authorization: Bearer <JWT> per chiamare come utente registrato. Lo Studio chiama gli stessi percorsi con un token di sessione della console, che gli conferisce il ruolo admin.

Qualsiasi altro percorso risponde 403 a anon e 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" } }

Formato. I corpi sono JSON e necessitano di Content-Type: application/json. Un successo è { "data": …, "meta": null }. Un errore è { "error": { "code", "message", "type", "request_id" } }.

Oggetto funzione.

Note:

• POST è un upsert su name: pubblicare un nome esistente ne sostituisce il codice. Un campo env_vars in quel corpo sostituisce le variabili esistenti; omettilo per mantenerli.
• In PATCH, permissions viene unito campo per campo: { "permissions": { "timeout_secs": 60 } } mantiene allow_net e memory_mb. Un campo fuori dai suoi limiti restituisce 400.
• PUT …/env sostituisce l'intero set di variabili ed è l'unico percorso che le crittografa. Vedi segreti.
• Una funzione con is_active: false non viene trovata da invoke o dai lavori.

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. Ruolo: anon, authenticated o service_role.

Risposta predefinita, sempre 200:

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

status è lo stato di la tua funzione. logs è vuoto per deno. In modalità raw la risposta è quella della tua funzione: status, content-type, byte, più x-aurabase-invoke-origin: function.

Oggetto lavoro: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at. Comportamento: Job, cron e coda dei messaggi non recapitati.

Voce: id, project_id, name, schedule (memorizzato con 6 campi), function_name, payload, is_active, last_run, next_run, created_at.

Valori e comportamento: Avvisi.