I would argue the offering is actually very clear. A nice demo is included. If you’re not using any REST clients it might be a bit harder to understand but I doubt you’re the intended target group
My take:
RecipeUI a Postman-like tool that offers convenient type safety and autocomplete on top of what Postman already does.
What is Postman?
It's a tool that allows you to configure, save, and replay HTTP requests. It helps developers building backend server APIs, so they don't have to keep fiddling around with their frontend. In many greenfield projects, the frontend doesn't even exist yet and Postman is effectively the only way to easily test what you're working on.
The alternative to postman is writing custom Python/NodeJS/etc programs to send these requests or painfully doing it with curl and bash.
I think it's cool and I'll probably try it the next time I have to work on REST APIs.
Honestly I'm still not entirely sold on the idea of Postman, for sending a simple HTTP request I find the python requests library a lot more intuitive to work with.
Then again I'm mostly looking at APIs to eventually use them in some other python script so perhaps my use case is not the best fit.
Unless the API does something weird you can do a lot worse than using curl and bash. I mean even using telnet (or openssl s_client) is not too bad if you're only doing a simple GET.
Postman is great for sharing API collections with others, especially if they aren’t a developer. Adding type safety to it is a great way to provide hints for acceptable values.
