API Reference

Tabular reference for api.wheelofheaven.world — endpoint catalogue, response envelope, controlled vocabularies, JSON Schemas, language routing, and changelog.

6 pages in this section

Reference docs for the api.wheelofheaven.world JSON API. For the narrative / rationale — what the API is, who it’s for, how it’s built — see architecture/sites/api.

In this section#

PageWhat
EndpointsEvery URL, its method, what it returns, sample response
EnvelopeThe { apiVersion, kind, metadata, data, links } shape
EnumsControlled vocabularies returned by /v1/enums/
SchemasJSON Schemas returned by /v1/schema/
MultilingualLanguage routing — /v1/{lang}/...
ChangelogVersioning policy and v1 evolution history
  • Endpoints Every URL exposed by api.wheelofheaven.world, organised by resource family.
  • Response Envelope The common envelope shape returned by every endpoint.
  • Enums Controlled vocabularies returned by /v1/enums/.
  • Schemas JSON Schemas returned by /v1/schema/ — one per resource kind.
  • Multilingual Routing How language is expressed in the API — path-prefix mirror.
  • Changelog Version history of api.wheelofheaven.world — and the versioning policy that constrains future changes.

Edit this page on GitHub