search

dwyl / learn-api-design

🏙️ Essential learning for people building APIs
813 stars 117 forks source link

Additional resources #25

Open mitchellporter opened 8 years ago

mitchellporter commented 8 years ago

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 commented 8 years ago

@mitchellporter these are great additions! Please PR! 👍

nelsonic commented 8 years ago

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

addityasingh commented 7 years ago

@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