Edge Functions HTTP एपीआई संदर्भ

बेस यूआरएल. आपके प्रोजेक्ट का URL, उदाहरण के लिए https://my-app.aurabase.cloud। प्रोजेक्ट की पहचान होस्ट द्वारा की जाती है, इसलिए नीचे दिए गए पथों में कोई प्रोजेक्ट आईडी नहीं है। लंबा फॉर्म /v1/functions/{project_id}/… भी स्वीकार किया जाता है।

प्रमाणीकरण. अपनी कुंजी apikey हेडर में भेजें। साइन-इन उपयोगकर्ता के रूप में कॉल करने के लिए Authorization: Bearer <JWT> जोड़ें। स्टूडियो उन्हीं मार्गों को कंसोल सत्र टोकन के साथ कॉल करता है, जो इसे admin भूमिका देता है।

कोई अन्य मार्ग 403 से anon और 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" } }

प्रारूप. निकाय JSON हैं और उन्हें Content-Type: application/json की आवश्यकता है। एक सफलता { "data": …, "meta": null } है। एक विफलता { "error": { "code", "message", "type", "request_id" } } है।

फ़ंक्शन ऑब्जेक्ट।

टिप्पणियाँ:

• POST name का एक संस्करण है: किसी मौजूदा नाम को पोस्ट करने से उसका कोड बदल जाता है। उस निकाय में एक env_vars फ़ील्ड मौजूदा चर को प्रतिस्थापित करता है; उन्हें रखने के लिए इसे छोड़ दें.
• PATCH में, permissions को फ़ील्ड दर फ़ील्ड मर्ज किया जाता है: { "permissions": { "timeout_secs": 60 } } allow_net और memory_mb रखता है। अपनी सीमा के बाहर का फ़ील्ड 400 लौटाता है।
• PUT …/env वेरिएबल के पूरे सेट को प्रतिस्थापित करता है और यह एकमात्र मार्ग है जो उन्हें एन्क्रिप्ट करता है। रहस्य देखें।
• is_active: false वाला फ़ंक्शन invoke या नौकरियों द्वारा नहीं पाया जाता है।

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. भूमिका: anon, authenticated या service_role।

डिफ़ॉल्ट प्रतिक्रिया, हमेशा 200:

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

status आपके फ़ंक्शन की स्थिति है। logs deno के लिए खाली है। रॉ मोड में प्रतिक्रिया आपके फ़ंक्शन की अपनी होती है: स्थिति, content-type, बाइट्स, प्लस x-aurabase-invoke-origin: function।

कार्य वस्तु: id, project_id, function_name, payload, status (pending, running, completed, failed, dead), attempts, max_attempts, error, scheduled_at, started_at, completed_at, created_at। व्यवहार: जॉब्स, क्रॉन और डेड-लेटर कतार।

प्रविष्टि: id, project_id, name, schedule (6 फ़ील्ड के साथ संग्रहीत), function_name, payload, is_active, last_run, next_run, created_at।

मूल्य और व्यवहार: अलर्ट।