Presented at the API Strategy & Practice Conference in Amsterdam, Netherlands

1. Full-on Hypermedia APIs
Markus Lanthaler

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

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

4. 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

5. 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

6. 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

7. 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

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

9. 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

10. 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

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

12. {
"@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

15. {
"@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

16. {
"@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

17. {
"@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

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

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

21. {
"@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
}
}
}
}

22. {
"@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
}
}
}
}

23. {
"@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
}
}
}
}

24. Hydra Console

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

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

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

32. 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/