Additional resources

[mitchellporter]

Not sure if you would be interested in having any of these added to the README but here are a couple of bookmarks I have that have been helpful in learning to design API's:

Guidelines / Best Practices
https://github.com/interagent/http-api-design
https://github.com/gocardless/http-api-design

Cheat sheets:
https://github.com/RestCheatSheet/api-cheat-sheet
https://github.com/cliffwoo/rest-api-cheat-sheet/blob/master/REST-API-Cheat-Sheet.md

Would be happy to submit a PR for the README if any of these are appropriate.

[nelsonic]

@mitchellporter these are great additions! Please PR! 👍

[nelsonic]

also: https://www.thoughtworks.com/insights/blog/rest-api-design-resource-modeling

[addityasingh]

@nelsonic Also have a look at this http://zalando.github.io/restful-api-guidelines/. We have created this at Zalando and have been using it rigorously and it has been proven to be very effective. Add to this the api validator https://zalando-incubator.github.io/zally/, it gives you a lot of power while starting to design an API