API Reference
This section documents the live HTTP surfaces of the SZL flagships. Where a flagship publishes an OpenAPI spec, this site renders it; where a spec is not yet published, the endpoint tables below are the authoritative reference.
OpenAPI auto-generation status
- killinchu — live FastAPI service; its OpenAPI schema is served at
/openapi.jsonon the Space. The killinchu API page mirrors it. - a11oy — consumed as a TypeScript package, not a public HTTP API. Its typed surface is documented on the flagship page.
- Provenance Anchor / Operator / Policy — roadmap roles, not released as packages or public HTTP APIs today.
- Auto-generated OpenAPI doc pages for any future public HTTP service are in development; this index will render them as specs publish.
Live HTTP surfaces
| Flagship | Surface | Reference |
|---|---|---|
| killinchu | FastAPI on HF Space — counter-UAS, decoders, receipts | /api/killinchu/* |
| a11oy | TypeScript package (no public HTTP) | flagship page |
| Provenance Anchor | roadmap — not released | flagship page |
| Operator | roadmap — not released | flagship page |
| Policy | roadmap — not released | flagship page |
Conventions
- Receipts. Every state-changing call returns a Khipu receipt:
{ sha256, prevRoot, lamport, signature, chain_verified }withsignature: "DSSE-PLACEHOLDER". - Honest errors. Malformed input returns a 4xx with an explicit error body — never a silent pass (a Doctrine v11 §2 measurability-honesty requirement).
- Health. Services expose
/healthz(liveness) and/readyz(readiness).