REST & Hypermedia: the missing links and why you need them - Ruby Hoedown 2012

GET /greetingContent-Type: text/plainHello :)

Saturday, September 22, 12

About Me

• Phil Harvey, @philharvey

• Web Developer

• Member of the architecture team

• The Lampo Group, Inc.

• daveramsey.com


REST & HypermediaThe Missing Links and Why You Need Them


Purpose


Common Scenario

You built an API for a business need...


Common Scenario

The business grows, matures, and changes...


Common Scenario

Leading to new, unanticipated requirements...


Common Scenario

New functionality is needed! But...


Common Scenario

You must not break existing clients!


Hypermedia


api.example.com

Tickets (/tickets)

Ticket (/ticket)


Three Examples...UPDATE: My three examples are now located in a Gist on GitHub, right here:

https://gist.github.com/3766847

Feel free to comment on them there. Thanks!

- Phil Harvey




Hypermedia Constraint

• Minimal API surface area

• Discoverable Transitions

• Looser coupling, higher extensibility, reduced breakage

• Independent evolution/innovation of Client and Server systems


Hypermedia gives you wings!


Questions, comments?


Resources

• Roy Fielding’s dissertation:

• http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm

• Google groups:

• API Craft, Hypermedia Web, REST-Discuss

• Implementing REST/Hypermedia APIs:

• http://code.google.com/p/implementing-rest/


http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm

http://www.ics.uci.edu/~fielding/pubs/dissertation/top.htm

http://code.google.com/p/implementing-rest/

http://code.google.com/p/implementing-rest/

Thanks!


REST & Hypermedia: the missing links and why you need them - Ruby Hoedown 2012

Technology

Transcript of REST & Hypermedia: the missing links and why you need them - Ruby Hoedown 2012