API & Development
API & Development
HTTP surfaces of alexandria-server and alexandria-client, authentication, observability, the conformance suite and the development workflow.
API & Development
Alexandria exposes three HTTP surfaces:
/v1onalexandria-server— the management API. JSON-LD, OAuth 2.0 bearer tokens, problem documents on error./pubonalexandria-server— public, immutable publication.- The admin listener of
alexandria-client— status, rules, agreements, audit, health and metrics. The traffic listeners are transparent proxies and expose no API of their own.
Endpoints
Every route of /v1, /pub and the client admin API, with who may call it.
Authentication & Authorization
Token checks A1–A5, the authorization table, problem responses and the laboratory identity provider.
Observability
Structured logs, OpenTelemetry export, trace correlation, events and metrics.
Conformance & Traceability
81 requirements, 76 of 77 catalog codes, the F6 scenario and the generated traceability matrix.
Testing & CI
Make and Task targets, test conventions, architecture tests and the GitHub Actions pipeline.