As soon as we start working on an API, design issues arise. A robust and strong design is a key factor for API success. A poorly designed API will indeed lead to misuse or – even worse – no use at all by its intended clients: application developers.
Creating and providing a state of the art API requires taking into account:
RESTful API principles as described in the literature (Roy Fielding, Leonard Richardson, Martin Fowler, HTTP specification…)
The API practices of the Web Giants…
Sourced through Scoop.it from: blog.octo.com
A practical guide about how to design a REST API with loads of links to further useful resources.