POST http://httpbingo.org/anything/chat
content-type: application/json
{
"message": "Hello!"
}
We extend it a bit to add checks on response, and add request chaining, but it's basically HTTP 1.x as this article shows it. A lot of others tools have the same idea, with minor differences:- Hurl (I'm one of the maintainer) https://hurl.dev
- HTTP Client https://www.jetbrains.com/help/idea/http-client-in-product-c...
- httpYac https://httpyac.github.io
- restclient.el https://github.com/pashky/restclient.el
- REST Client https://github.com/Huachao/vscode-restclient
- verb https://github.com/federicotdn/verb
And many more...
Worth noting, other tools have taken the YAML route (like Step CI https://stepci.com), JavaScript (k6 https://k6.io/docs/using-k6/http-requests/)... I'm biased of course, I've a tiny preference for the simple plain text format.
And of course, there are also GUI application (Postman, Insomnia, RecipeUI amon others)
[1]: https://hurl.dev
I follow the same approach. Emacs, Verb[0] and org-mode. An alternative to Verb would be restclient.el[1] but I like Verb more because it works as an extension to org-mode which is great for documentation.
[0] https://github.com/federicotdn/verb [1] https://github.com/pashky/restclient.el
It lets you write the api, test it and generate the documentation all from the same source of truth file.
There is also Verb mode (org-mode extension) which seems like a nice alternative to restclient.el. Learnt about via Impostman[2] which imports Postman collections to both restclient.el and verb.el