idea: Replace /api with Swagger Docs

[sam57719]

Swagger docs page requires a minimal HTML page with a JSON document outlining the spec

Would be pretty simple to add and would be useful!

An easy way of generating a valid schema would be to create a fastapi app that replicates the interface, this would generate a schema with the data-models and endppints.

This could be then copied into SMIBHID.

I am happy to implement this down the road.

[sjefferson99]

Yes, looks like it has potential.
https://swagger.io/docs/open-source-tools/swagger-ui/usage/installation/#plain-old-htmlcssjs-standalone

[sam57719]

It's even simpler than that, as no need to store anything really in the HTML, practically all of it can be pulled client side, reducing the storage impact on the pico.