Edge Functions Справочник по HTTP API

Базовый URL. 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. Поведение: Задания, cron и очередь недоставленных сообщений.

Запись: id, project_id, name, schedule (хранится в 6 полях), function_name, payload, is_active, last_run, next_run, created_at.

Значения и поведение: Оповещения.