tpluscode / rest-workshop

Arktekk's REST Workshop

This material is a two day workshop on REST. It is divided into three areas: slides for an instructor, exercises for the participants and instructor's notes.

The slides cover the theoretical aspects of REST and HTTP. They form the basis for discussions and exercises.

Exercises for getting hands on with REST and HTTP. The exercises are practical and directly useful afterwards. The exercises takes you from a basic "RPC over HTTP" application to a good HTTP component.

There is a whole lot of information on what REST and is and is not, but we're trying to introduce you to REST through a practical examples and exercises. As REST is not a single architecture but rather an architectonic style, we can only show you some ways to use this style. We're doing this through discussions during and after the presentations. You'll try yourself in the exercises.

Participant Requirements

There are a few things you have to install and set up before trying out the exercises, see Participant Requirements.

Exercises

More information on the slides is available under exercises/README.md.

Slides

The slides are available under slides. They use Reveal.JS as a presentation tool.

MongoDB

There is a script for windows and *nix platforms to run mongodb.

Resources and Links

1. http://martinfowler.com/articles/richardsonMaturityModel.html
2. http://tools.ietf.org/html/rfc2616
3. http://tools.ietf.org/html/rfc5988
4. http://tools.ietf.org/html/rfc6265
5. http://tools.ietf.org/html/rfc6266
6. http://tools.ietf.org/html/rfc6570
7. http://tools.ietf.org/html/rfc6585
8. http://www.greenbytes.de/tech/webdav/draft-ietf-httpbis-method-registrations-latest.html
9. http://www.iana.org/assignments/http-status-codes/http-status-codes.xml
10. http://www.iana.org/assignments/link-relations/link-relations.xml
11. http://www.iana.org/assignments/message-headers/perm-headers.html
12. http://www.iana.org/protocols/
13. http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm
14. http://www.nordsc.com/ext/classification_of_http_based_apis.html
15. http://shop.oreilly.com/product/0636920020530.do - Building Hypermedia APIs with HTML5 and Node
16. http://shop.oreilly.com/product/9780596805838.do - REST in Practice Hypermedia and Systems Architecture
17. http://vimeo.com/49305646 - HTTP-Caching for fun and profit

Contact

Erlend Hamnaberg Trygve Laugstøl