REST and gRPC

PostgreSQL extensions. Specs generated from database/init/015_api.sql.

Workers parse the protocol and run api.handle_http / api.handle_grpc. Authorization stays in SQL. There is no FastAPI sidecar.

openapi.json efelant.proto

Access

Listeners

efelant_rest

:18080 · REST · live spec at /v1/openapi.json

efelant_grpc

:18081 · Connect / gRPC-JSON · POST /efelant.v1.Efelant/{Method}

HTTP/2 + protobuf framing is not implemented. Proto is also at GET /v1/efelant.proto.

Auth

Authorization: Bearer <token>

A human session token, or an API client token (efl_…, shown once) created by a tenant owner/admin. Scopes: tenants:read, contexts:read, contexts:write, events:read, events:write, clients:write.

Specs

REST

Read-only OpenAPI from api.handle_http. Expand an operation for description, parameters, and status codes.

Loading spec…

gRPC

Connect JSON mapping of efelant.v1.Efelant, from api.protobuf() and api.handle_grpc. POST /efelant.v1.Efelant/{Method} on :18081.

Loading spec…