Tootfinder

Opt-in global Mastodon full text search. Join the index!

@michabbb@social.vivaldi.net
2026-04-08 20:10:21

πŸ“– Automatic API documentation:
PostgREST generates #OpenAPI specs automatically from your schema. Hook up Swagger-UI − interactive, always up-to-date docs for your API. No more manual doc maintenance.
πŸ—οΈ Versioning through DB schemas:
Instead of managing API versions in code, PostgREST uses #PostgreSQL

@michabbb@social.vivaldi.net
2026-04-05 06:46:25

πŸ› οΈ Code generation with diff preview, cURL builder from captured requests, one-click request replay, VS Code-style command palette (Ctrl K), built-in Swagger UI & dark/light theme with PWA offline support
🌐 Language-agnostic API (#OpenAPI 3.1) - send debug data from #Python,

@jamesthebard@social.linux.pizza
2026-03-11 17:31:22

Documentation continues. Done with the `queue` and `worker` endpoints, probably about 50% of the way done with this. I still need a good way to package all of this up with the binary which means putting the `openapi.yaml` file somewhere on the net so it can be pulled if need be. I'll deal with that later...lol
#openapi

OpenAPI being rendered by Scalar as nice documentation.  Shows the 5 queue routes and 5 worker routes along with model information.
A ton of YAML that comprises the OpenAPI file.  Still have a ton of work left to do.
@a@paperbay.org
2026-03-14 17:16:34

Why using a MCP when you have a clean OpenAPI with consistent results?
#ai #openapi #mcp

@jamesthebard@social.linux.pizza
2026-03-11 05:04:19

Now the pain in the ass part: documenting all of the routes. I think I'm gonna use Scalar because it's easy and I'm pretty lazy. Carved off the `/doc` directory to host the `openapi.yaml` and `index.html` files. So far, got one single endpoint documented...lol
#openapi #sisyphus

The `/doc` page showing the Sisyphus Server API documentation for v2.0.1.
Actually executing the GET request on the `/queue` endpoint.  The page shows the response and a ton of options that I'm kinda digging.