Hydra
AVocabulary for HypermediaAPIs
Markus Lanthaler
Graz University ofTechnology

Why can’t Web APIs be browsed?

- Layered system

REST + Linked Data: a match made!?

Resource
Link
Form
Class
rdfs:Resource
rdf:Property
rdfs:Class
Operation

Resource
Link
Form
Class
rdfs:Resource
rdf:Property
rdfs:Class
Operation
Templated

{
"id": "cso29ax",
"title": "LDOW2013 presentation",
"description": "Prepare LDOW2013 presentation",
"is_open": true,
"created_at": "2012-11-26T04:49:44Z",
"comments": "/issues/cso29ax/comments/"
}
http://example.com/issues/cso29ax

{
"@context": "/ctx/context.jsonld",
"id": "cso29ax",
"title": "LDOW2013 presentation",
"description": "Prepare LDOW2013 presentation",
"is_open": true,
"created_at": "2012-11-26T04:49:44Z",
"comments": "/issues/cso29ax/comments/"
}
http://example.com/issues/cso29ax
{
"@id": "#comments",
"@type": "hydra:Link",
...
}

{
"@id": "#comments",
"@type": "hydra:Link",
"supportedOperations": [
{
"@id": "#create-comment",
"@type": "hydra:CreateResourceOperation",
"label": "Creates a new comment",
"method": "POST",
"expects": "#Comment",
"returns": "#Comment"
}
]
}

{
"@id": "#Comment",
"@type": "hydra:Class",
"supportedProperties": [
{
"property": "#text",
"required": true,
"readonly": false,
"writeonly": false
}
]
}

Hydra Console

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

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

Image Credits
(1) http://www.flickr.com/photos/ecstaticist/3650101568/
(2) http://www.flickr.com/photos/eole/8138645952/
(5) http://www.vonwong.com/ (with permission)