This site makes a big point of using the term "RESTful" repeatedly, but it seems to be JSON-based by default?
I don't know why modern web frameworks insist on continuing to misuse or misapply the term despite a fairly large amount of messaging recently about how exactly this term is misapplied, and the resurgence of frameworks and tools that do correctly apply it, e.g. HTMX, Datastar, Alpine AJAX.
Otherwise, this looks cool. I'd encourage you to un-roll-your-own docs and use something like Starlight or Docusaurus so you can have usable search and versioned docs.
That's a fight we lost two decades ago now unfortunately. Nearly any modern-ish API is a JSON-based RPC. There's nothing wrong with that, JSON RPC is a plenty fine solution for many common use cases, it just isn't REST.
>An application that adheres to the REST architectural constraints may be informally described as RESTful, although this term is more commonly associated with the design of HTTP-based APIs and what are widely considered best practices regarding the "verbs" (HTTP methods) a resource responds to, while having little to do with REST as originally formulated—and is often even at odds with the concept.
I don't know why modern web frameworks insist on continuing to misuse or misapply the term despite a fairly large amount of messaging recently about how exactly this term is misapplied, and the resurgence of frameworks and tools that do correctly apply it, e.g. HTMX, Datastar, Alpine AJAX.
Otherwise, this looks cool. I'd encourage you to un-roll-your-own docs and use something like Starlight or Docusaurus so you can have usable search and versioned docs.