Full-on Hypermedia APIs
Markus Lanthaler

{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>
{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
{
69 64: 61 73 31 34,
6E 61 6D 65: 41 50 49 20 53 74 72 61 74 65 67 79 …
73 74 61 72 74 44 61 74 65: 32 30 31 34 2D 30 33 …
65 6E 64 44 61 74 65: 32 30 31 33 2D 30 33 2D 32 …
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
http://example.com/events/as14
/events/as14
/events/as14/attendees

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
{
69 64: 61 73 31 34,
6E 61 6D 65: 41 50 49 20 53 74 72 61 74 65 67 79 …
73 74 61 72 74 44 61 74 65: 32 30 31 34 2D 30 33 …
65 6E 64 44 61 74 65: 32 30 31 33 2D 30 33 2D 32 …
}
http://example.com/events/as14

Link: <http://example.com/events/as14/attendees/>;
rel="http://example.com/rels/attendees"
{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28"
}
http://example.com/events/as14

{
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28",
"attendees": "/events/as14/attendees/"
}
http://example.com/events/as14

{
"@context": {
"@vocab": "http://schema.org/"
},
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28",
"attendees": "/events/as14/attendees/"
}
http://example.com/events/as14

{
"@context": {
"@vocab": "http://schema.org/"
},
"id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28",
"attendees": "/events/as14/attendees/"
}
http://example.com/events/as14

{
"@context": {
"@vocab": "http://schema.org/"
},
"@id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28",
"attendees": "/events/as14/attendees/"
}
http://example.com/events/as14

{
"@context": {
"@vocab": "http://schema.org/"
},
"@id": "as14",
"name": "API Strategy & Practice Conference",
"startDate": "2014-03-26",
"endDate": "2013-03-28",
"attendees": { "@id": "/events/as14/attendees/" }
}
http://example.com/events/as14

{
"@context": {
"@vocab": "http://schema.org/"
},
"@id": "/events/as14/attendees/"
}

{
"@context": [
{ "@vocab": "http://schema.org/" },
"http://www.w3.org/ns/hydra/core"
],
"@id": "/events/as14/attendees/"
}

{
"@context": [
{ "@vocab": "http://schema.org/" },
"http://www.w3.org/ns/hydra/core"
],
"@id": "/events/as14/attendees/",
"operation": {
"@type": "AddAction",
"method": "POST",
"expects": {
"@id": "Person",
"supportedProperty": {
"property": "name",
"required": true
}
}
}
}

{
"@context": [
{ "@vocab": "http://schema.org/" },
"http://www.w3.org/ns/hydra/core"
],
"@id": "/events/as14/attendees/",
"operation": {
"@type": "AddAction",
"method": "POST",
"expects": {
"@id": "Person",
"supportedProperty": {
"property": "name",
"required": true
}
}
}
}

{
"@context": [
{ "@vocab": "http://schema.org/" },
"http://www.w3.org/ns/hydra/core"
],
"@id": "http://schema.org/attendees",
"supportedOperation": {
"@type": "AddAction",
"method": "POST",
"expects": {
"@id": "Person",
"supportedProperty": {
"property": "name",
"required": true
}
}
}
}

Hydra Console

© 2014, Markus Lanthaler. Some Rights Reserved.
http://creativecommons.org/licenses/by-nc-sa/4.0/
Thank You

© 2014, Markus Lanthaler. Some Rights Reserved.
http://creativecommons.org/licenses/by-nc-sa/4.0/
SpecialThanks to

Questions?
Markus Lanthaler
http://www.markus-lanthaler.com
@MarkusLanthaler
mail@markus-lanthaler.com

Image Credits
(1) http://www.flickr.com/photos/piper/2890945512/
(13) http://schema.org/attendees
(14) http://schema.org/Event
(18) http://www.vonwong.com/