Aurabase Logo
아우라베이스문서
Aurabase Logo
아우라베이스문서
API/Functions/Invoquer une edge function

Invoquer une edge function

POST/v1/functions/{project_id}/{name}/invoke

Déclenche un handler déployé. Le corps de la requête n'est PAS transmis tel quel : il décrit la requête à rejouer (method, path, headers, body).

#
Request

En-têtes

apikey요구사항
Clé API du projet
Authorization
Bearer <JWT utilisateur>
Content-Type요구사항
application/json
x-aurabase-invoke-mode
raw → renvoie la réponse brute de la fonction (statut, content-type et octets réels) au lieu de l'enveloppe { data, meta }
#
Request

Body

methodstring옵션
Méthode HTTP vue par le handler. Défaut POST.
pathstring옵션
Chemin vu par le handler. Défaut /.
headersobject옵션
En-têtes transmis au handler (paires chaîne → chaîne).
bodyany옵션
Charge utile transmise au handler.
Info
Ces quatre champs décrivent la requête que votre fonction reçoit. Sur le runtime Deno, req.method, new URL(req.url).pathname, req.headers et await req.json() rendent exactement ce que vous avez envoyé — body est le corps applicatif, pas l'enveloppe. GET et HEAD partent sans corps (spec Fetch).
#
메모

Idempotence

Attention
Idempotency-Key n'est pas lu sur cette route : aucune déduplication n'est faite, deux invocations identiques s'exécutent deux fois. Si vous avez besoin d'idempotence, gérez-la dans le code de la fonction.
#
메모

Limites d'exécution

Info
Le timeout est réglé par fonction : défaut 30 s, plafond dur 300 s (5 min) — il n'est pas fonction du plan. La mémoire va de 16 à 1024 Mo. Les invocations sont limitées à leur propre profil de débit, et chaque appel consomme le quota functions.invocations du projet.
#
메모

Exécution asynchrone

Astuce
Pour du travail long, préférez la file de jobs : POST /v1/functions/{project_id}/jobs, suivi de GET …/jobs/{job_id}, avec relance (…/retry) et file de rebut (…/jobs/dlq).
v1.0 · révisé 15 avr. 2026