Every story and comment from the Hacker News API, in a layout borrowed from 2001.
A comment on Ask HN: Rest api authorization.
For the rest: http://www.javabeat.net/rest-api-best-practices/
And documentation: https://github.com/Rebilly/ReDoc/blob/master/README.md
There many more comprehensive resources about sane API design (use HATEOAS, pagination, etc.) but you don't have to implement everything from v1
ps. SSL goes without saying even if it's a public API
There are no comments on this comment yet.
For the rest: http://www.javabeat.net/rest-api-best-practices/
And documentation: https://github.com/Rebilly/ReDoc/blob/master/README.md
There many more comprehensive resources about sane API design (use HATEOAS, pagination, etc.) but you don't have to implement everything from v1
ps. SSL goes without saying even if it's a public API