Allen Helton
Feb 24, 2023

--

I don't want to come off "all fundamentalism is bad." But when considering the best developer experience possible, sometimes it's ok to bend the rules a little bit.

When I say fundamentalism, I mean "adhering strictly to the rules and guidelines". Taking REST as an example, you aren't supposed to include verbs in your paths (source: https://cloud.google.com/blog/products/api-management/restful-api-design-nouns-are-good-verbs-are-bad)

If you could roll up 3 or 4 endpoints into a single command, then that might be a tradeoff worth considering - ease of use vs strictly following the rules.

--

--

Allen Helton
Allen Helton

Written by Allen Helton

I am an AWS serverless hero with a strong focus on API design and standardization, event-driven architectures, and software automation.

Responses (1)