Please check this draft: https://medium.com/software-craftsmanship/9e8f0b85e9?kme=collabEmail.clicked&km_postIds=9e8f0b85e9
You should read about hypermedia APIs, if only to challenge your thinking. It helped me a lot to do just that.
- How to GET a cup of coffee http://www.infoq.com/articles/webber-rest-workflow
- My Week With The Hypermedia Cowboys: http://wekeroad.com/2012/03/13/my-week-with-the-hypermedia-cowboy, http://wekeroad.com/2012/03/18/alt-tekpub-consuming-the-api, http://wekeroad.com/2012/03/22/alt-tekpub-working-more-with-the-hypermedia-style-api, http://wekeroad.com/2012/03/26/loading-data-from-the-api-how-much-is-too-much
- How much rest should your web api get http://blog.restlet.com/2013/05/02/how-much-rest-should-your-web-api-get/
- How I learned to stop worrying and love REST http://mikemayo.org/2012/how-i-learned-to-stop-worrying-and-love-rest/
- What the hell is Hypermedia API and Why should I care? http://2beards.net/2012/03/what-the-hell-is-a-hypermedia-api-and-why-should-i-care/
- Nobody understands rest or http http://blog.steveklabnik.com/posts/2011-07-03-nobody-understands-rest-or-http
- Rest is over http://blog.steveklabnik.com/posts/2012-02-23-rest-is-over
- Hypermedia API's, part one http://andrewdupont.net/2012/12/21/hypermedia-apis-part-one/
- Media Types: http://amundsen.com/hypermedia/
- H Factor: http://amundsen.com/hypermedia/hfactor/
- A Hypermedia API Reading List http://blog.steveklabnik.com/posts/2012-02-27-hypermedia-api-reading-list
- Haters gonna HATEOAS http://timelessrepo.com/haters-gonna-hateoas
- REST API's must be hypertext driven http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven
- Some people understand REST and HTTP http://blog.steveklabnik.com/posts/2011-08-07-some-people-understand-rest-and-http
- I invented Hypermedia API's by accident http://words.steveklabnik.com/i-invented-hypermedia-apis-by-accident
- Hypermedia APIs: The New Wild West? http://decomplecting.org/blog/2012/05/30/hypermedia-apis-the-new-wild-west/
- Desinging Hypermedia API's http://www.designinghypermediaapis.com/
- Building Hypermedia APIs with HTML5 and Node http://www.amazon.com/gp/product/1449306578/
- RESTful web services http://www.amazon.com/RESTful-Web-Services-Leonard-Richardson/dp/0596529260
- REST in Practice: Hypermedia and Systems Architecture http://www.amazon.com/REST-Practice-Hypermedia-Systems-Architecture/dp/0596805829
- Hypermedia API Tutorial (Part 1) http://www.infoq.com/articles/hypermedia-api-tutorial-part-one
- Hypermedia API Tutorial (Part 2) http://www.infoq.com/articles/hypermedia-api-tutorial-part-two
- Use Hypermedia-Style Messages to Build Flexible, Durable APIs http://www.layer7tech.com/tutorials/hypermedia-apis
- What is REST? http://www.restapitutorial.com/lessons/whatisrest.html
- Hypermedia for the iOS developer http://www.slideshare.net/KevinONeill1/hypermedia-for-the-ios-developer-swipe-2012
- Web Development Techniques http://www.infoq.com/presentations/web-development-techniques
- The Future of Media API http://www.infoq.com/presentations/media-API
- Huddle https://code.google.com/p/huddle-apis/wiki/BasicConcepts
- Wowzer https://api.wowzerapp.com/docs
- Reachably http://api.reachably.com/docs
- Github http://developer.github.com/v3/
- FoxyCart http://wiki.foxycart.com/v/0.0.0/hypermedia_api
- Paypal https://developer.paypal.com/webapps/developer/docs/api/
- Klarna https://docs.klarna.com/en/rest-api#api-overview
- Family Search https://familysearch.org/developers/docs/sample-app
- JSON API http://jsonapi.org/
- HAL http://stateless.co/hal_specification.html
- Collection+JSON http://amundsen.com/media-types/collection/
- Siren https://github.com/kevinswiber/siren
- JSON-LD http://www.markus-lanthaler.com/hydra/ http://json-ld.org/
- REST done right http://rubyrogues.com/rest-done-right-with-steve-klabnik/
- REST Discuss: http://tech.groups.yahoo.com/group/rest-discuss/
- HAL Discuss: http://hal-discuss.googlegroups.com
- HAL Discuss: http://api-craft.googlegroups.com
- The Costs and Benefits of Building Hypermedia APIs (with Node.js) http://www.infoq.com/presentations/Building-Hypermedia-API http://www.infoq.com/presentations/robinson-restful-enterprise
- Glenn Block on Hypermedia http://www.youtube.com/watch?v=vp-Na5wKlig
- Hypermedia APIs http://www.youtube.com/watch?v=neLZbo9X1Dk
- Hypermedia APIs - Jon Moore http://vimeo.com/20781278
- HTML Hypermedia APIs and Adaptive Web Design http://www.youtube.com/watch?v=YCjaOrIhYGg
- HATEOAS Your Cake and Eat It Too http://vimeo.com/49609648
- RPC to REST : Concrete Case on Payment APIs http://www.youtube.com/watch?feature=player_detailpage&v=Nh6VeuvVRdQ
- The road to REST http://www.infoq.com/presentations/REST-API-HATEOAS
- Confreak videos http://www.confreaks.com/videos?search=hypermedia
- Apiary http://apiary.io/
- HAL Browser
- Roar
- Hyperresource http://thechangelog.com/hyperresource-a-hypermedia-api-client-for-ruby/
- Frenetic https://github.com/dlindahl/frenetic
- Hyperclient https://github.com/codegram/hyperclient
- Draper https://github.com/drapergem/draper
- URI Template https://github.com/hannesg/uri_template
- Sawyer https://github.com/lostisland/sawyer