4 ms·
I do agree that client requirements come first of course, but after that DX is at the top of my list. They do differ fundamentally in that type safety is an af
by jrsj 3y ago
I do agree that client requirements come first of course, but after that DX is at the top of my list.
They do differ fundamentally in that type safety is an afterthought with REST but is built in with some of the alternatives. That can have it's benefits too of course, it's easier to integrate with and more broadly supported in part because it doesn't concern itself with that.
OpenAPI can help but keeping your schema in sync with reality can be a pain depending on what libraries you have available. In the best case it really is minimal work, but if you don't have good tooling for whatever web framework you're using it can be a bit of a pain. In my experience it often requires more manual effort to maintain & more risk of mistakes causing the schema to be inaccurate.