REST API best practices

[recidive]

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

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

[recidive]

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]

:+1:

[recidive]

https://bourgeois.me/rest/

[recidive]

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