search

recidive / choko

Choko Framework
http://choko.org
MIT License
25 stars 9 forks source link

REST API best practices #155

Open recidive opened 10 years ago

recidive commented 10 years ago

We need to assess our REST API and implement some best practices.

http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api

recidive commented 10 years ago

Some other useful Links:

Status Codes:

http://www.restapitutorial.com/httpstatuscodes.html

Worst practices we need to get rid of if any:

http://jacobian.org/writing/rest-worst-practices/

URL design best practices:

http://blog.2partsmagic.com/restful-uri-design/

jardix22 commented 10 years ago

:+1:

recidive commented 9 years ago

https://bourgeois.me/rest/

recidive commented 9 years ago

It would be nice if we implement at least a subset of Swagger Specification 2.0:

https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md