Skip to content

HTTP APIs

All routes are served on the same generated domain as this website.

GET /api/health

Returns service metadata.

{"ok":true,"service":"tmpl_docs_kit","docs":"Material for MkDocs on Taubyte"}

GET /api/versions

Returns the example release train used by the Live APIs table.

Field Type Meaning
product string Display name
current string Latest stable
versions[] array History entries

POST /api/feedback

Body:

{
  "name": "Ada",
  "email": "ada@example.com",
  "page": "/live/",
  "rating": 5,
  "message": "Search + dark mode work."
}

Rules:

  • message required (max 2000 chars)
  • rating clamped to 1–5 (default 5)
  • emails stored but stripped from public list responses

GET /api/feedback

{
  "count": 1,
  "average": 5.0,
  "items": [{ "id": "...", "name": "Ada", "rating": 5, "message": "...", "page": "/live/", "ts": "..." }]
}