Aside from Vinay's guide that has already been mentioned - http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api http://www.vinaysahni.com/best-p

Aside from Vinay's guide that has already been mentioned - http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api http://www.vinaysahni.com/best-practices-for-a-pragmatic-res... There is also this Medium post: https://bradfults.com/the-best-api-documentation-b9e46400379a#.am4n12emj https://bradfults.com/the-best-api-documentation-b9e46400379...