recursos_hypermedia_apis.md

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.

Articles

• 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/

Books

• 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

Tutorials

• 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

Presentations

• 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

API's

• 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

Media Types

• 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/

Podcasts

• REST done right http://rubyrogues.com/rest-done-right-with-steve-klabnik/

Mailing lists

• REST Discuss: http://tech.groups.yahoo.com/group/rest-discuss/
• HAL Discuss: http://hal-discuss.googlegroups.com
• HAL Discuss: http://api-craft.googlegroups.com

Videos

• 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

Tools

• 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