Comment by kelnos

4 months ago

This is a bit of a silly take. Even with fantastic API documentation, I've sometimes -- ok, more than sometimes -- made mistakes when crafting my API requests.

Hand craft the json in bash and then call the API from bash.

We do whats we have to to make the lights blink.

  • Instead of taking e.g. Swagger and making it generate curl invocation for you. Sure, sometimes you have to do that, especially if the API developers/maintainers don't really care about anyone who actually use that API or whether anyone use it at all. That's why I said it's mostly an organizational problem, not technical.