## api
Public fetch API
Read-only, no keys, open CORS. Rate limits: 60 requests/min per IP (file endpoints 120). Responses use a { data, meta } envelope; raw files ship correct content types, ETags, and cache headers. Restricted entries answer 451 with a JSON reason.
curl -fsSL https://api.agent-ds.oday-bakkour.com/v1/systems/carbon/design.md
| endpoint | returns |
|---|---|
| GET /v1/systems | Paginated list — filters: path, category, q, license, sort, page, limit (max 100) |
| GET /v1/systems/{slug} | Full metadata + parsed token summary |
| GET /v1/systems/{slug}/design.md | Raw markdown (text/markdown) |
| GET /v1/systems/{slug}/tokens.json | W3C DTCG tokens |
| GET /v1/systems/{slug}/tailwind.css | Tailwind v4 @theme CSS |
| GET /v1/systems/{slug}/bundle.zip | Zip of the above + LICENSE-NOTICE.txt |
| GET /v1/categories | Purpose taxonomy with counts |
| GET /v1/health | Liveness/readiness |
Interactive OpenAPI docs live at https://api.agent-ds.oday-bakkour.com/docs. Base URL: https://api.agent-ds.oday-bakkour.com. Breaking changes will ship under /v2 — /v1 is stable.