Hypermedia Client Hackery

A RESTFest HackDay Proposal

####HackDay Info: LIVE SERVICE RUNNING HERE: http://hyper-hackery.herokuapp.com

Supported media types are:

• application/vnd.hal+json
• application/vnd.collection+sjon
• application/vnd.siren+json

service/example repo: https://github.com/RESTFest/ndcoslo2015

• CJ JSON Schema: https://github.com/mamund/collection-json/blob/master/schema/collection%2Bjson.json

NOTE: Example SPA client code can be found in the repo in the /files/ subfolder

###Goal Everyone builds their own (singly or in teams) generic Hypermedia Client. These client apps SHOULD be usable for any services (existing or future) that support hypermedia responses.

###Hypermedia API Server A Hypermedia API server will be available and running that supports the same API responses in the following formats:

• HAL
• Collection+JSON
• Siren
• UBER
• ???

NOTE: The initial server code will be posted to github before the hackathon begins and is likely to change along the way -- including during the hackathon.

###Building Your Client Each team/person can select which hypermedia format(s) will be supported by that client application. NOTE: Source code for sample client apps will be available for use and review.

###Changing the API The Hypermedia API Server will undergo "unexpected updates" throughout the hackathon day. The theory is that -- as the service changes -- the hypermedia client app will not only continue to work, but will exhibit the new features for free.

###The Stand Up At the end of the day, the client apps will be reviewed with the opportunity to recall unexpected pitfalls and successes along the way.

###The Takeaway We'll all learn what it takes to build resilient hypermedia consumers and just what kinds of adaptation is possible for an API client app.