Some good advice: https://github.com/stickfigure/blog/wiki/How-to-(and-how-not-to)-design-REST-APIs