now i remember reading a pretty good article about designing APIs but have completely misplaced it!
oh wells.
below are some other pretty good resources!
an easier read: https://hackernoon.com/restful-api-design-step-by-step-guide-2f2c9f9fcdbf
more comprehensive: https://docs.microsoft.com/en-us/azure/architecture/best-practices/api-design
if you are into graphQL: https://www.slideshare.net/AmazonWebServices/best-practices-for-designing-graphql-apis-that-scale-mob420r1-aws-reinvent-2018