Aurabase Logo
光环基地文档
Aurabase Logo
光环基地文档
应用程序编程接口/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