Skip to content

API (static JSON)

The website hosts a static API built from YAML sources.

This is intentionally simple:

  • No backend required
  • Cache-friendly (CDN / browser caching)
  • Easy to mirror and version

Endpoints

Paths are relative to the site root:

  • api/v1/index.json – top-level index
  • api/v1/entities/<entity_type>/<id>.json – single entity
  • api/v1/entities/<entity_type>/index.json – list of entities of a type
  • api/v1/taxonomies/<taxonomy>/<term_id>.json – single term
  • api/v1/taxonomies/<taxonomy>/index.json – list of terms in a taxonomy
  • api/v1/relations/<id>.json – single relation
  • api/v1/relations/index.json – list of relations

Guarantees

  • IDs are stable.
  • JSON is a direct, lossless representation of YAML (plus small build metadata in indexes).