Hacker News new | ask | show | jobs
by perlwle 1554 days ago
https://www.vinaysahni.com/best-practices-for-a-pragmatic-re...

Helped me get started with API design in my early career. Learning from other existing APIs helps too. such as stripe, github, shopify. Any others?

Something that We do at my current job:

* set a standard and stick with it. tweak it if needed. we even have naming standard on some of the json key. for example, use XXX_count for counting. when it doesn't make sense, use total_XXX.

* Document your API, we use postman and code review API changes too.