SlideShare a Scribd company logo
Web APIs
Alexandre Bertails, Pellucid Analytics
@bertails
1 / 46
Web APIs
Who are the users of my API?
What do they do with it?
How will they interact with it?
2 / 46
Web APIs
Who are the users of my API?
What do they do with it?
How will they interact with it?
REST
hypermedia
HATEOAS
3 / 46
HTTP, back to the basics
resources
representations
semantics
4 / 46
HTTP interactions
$HEADhttps://data.example.com/company/
Content-Type:application/json
a media type specification sets out
formats
processing model
hypermedia controls
for its representation
5 / 46
media type
Content-Type and Media Type as defined in HTTPBIS
HTTP uses Internet Media Types [RFC2046] in the Content-Type
(Section 3.1.1.5) [...] header fields in order to provide open and
extensible data typing [...]. Media types define both a data format and
various processing models.
6 / 46
IANA registry for media types
IANA registry for Media Types
Name Template Reference
json application/json [RFC7158]
7 / 46
JSON
The JavaScript Object Notation (JSON) Data Interchange Format [RFC7159]
JSON can represent four primitive types (strings, numbers, booleans,
and null) and two structured types (objects and arrays).
8 / 46
JSON
The JavaScript Object Notation (JSON) Data Interchange Format [RFC7159]
JSON can represent four primitive types (strings, numbers, booleans,
and null) and two structured types (objects and arrays).
No processing model defined in JSON! (neither in JSON-LD, HAL,
etc.)
9 / 46
extending media type semantics
what wouldthe RESTafarian do?
probably use a vendor specific media type
$HEADhttps://data.example.com/company/
Content-Type:application/vnd.example.company+json
10 / 46
Linkheader
rel=profile Link header
The 'profile' link relation type [...] allows resource representations to
indicate that they are following one or more profiles. A profile is
defined not to alter the semantics of the resource representation
itself, but to allow clients to learn about additional semantics [...] in
addition to those defined by the media type [...].
$HEADhttps://data.example.com/company/
Content-Type:application/json
Link:<https://data.example.com/ontology#Company>;rel="profile"
11 / 46
HATEOAS?
Hypermedia can be the engine of a single API.
Hypermedia cannot be the engine of cross-API interactions.
Ruben Verborgh, Hypermedia Cannot be the Engine
12 / 46
focusing on data
HATEOAS is like a hypermedia state machine
data modeling is a special case for application state
media type encodes kind/type
but few missing interactions eg. CRUD
13 / 46
data patterns in JSON
encodings
links
types
disambiguating schemas
Let's make JSON a hypermedia format :-)
14 / 46
a 1st version
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"id":"q6po09",
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"id":"c34dap",
"name":"Apple",
"ticker":"AAPL",
"industry":"q6po09"
}
documentation probably available at something like
https://data.example.com/api/documentation 15 / 46
things, not String-s
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"@id":"https://data.example.com/industry/q6po09",
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@id":"https://data.example.com/company/c34dap",
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
16 / 46
this is its own @id
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
17 / 46
what are we dealing with?
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"type":"Industry",
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
18 / 46
@type+ URL
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Industry"},
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Company"},
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
19 / 46
disambiguating attributes [1/3]
How to distinguish an industry's name from a company's name?
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Industry"},
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Company"},
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
20 / 46
disambiguating attributes [2/3]
How to distinguish an industry's name from a company's name?
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Industry"},
"https://data.example.com/ontology#industryName":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@type":{"@id":"https://data.example.com/ontology#Company"},
"https://data.example.com/ontology#companyName":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
21 / 46
disambiguating attributes [3/3]
How to distinguish an industry's name from a company's name?
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@context":{
"name":{"@id":"https://data.example.com/ontology#companyName"}
},
"@type":{"@id":"https://data.example.com/ontology#Company"},
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
22 / 46
contextualized data: typed values
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@context":{
"name":{"@id":"https://data.example.com/ontology#companyName"},
"ticker":{"@id":"https://data.example.com/ontology#ticker"},
"industry":{"@id":"https://data.example.com/ontology#industry"}
},
"@type":{"@id":"https://data.example.com/ontology#Company"},
"name":"Apple",
"ticker":"AAPL",
"industry":{"@id":"https://data.example.com/industry/q6po09"}
}
23 / 46
contextualized data: default vocabulary
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"@context":{
"@vocab":"https://data.example.com/ontology#",
"name":"companyName",
"ticker":{"@type":"Ticker"},
"industry":{"@type":"@id"}
},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":"https://data.example.com/industry/q6po09"
}
24 / 46
JSON-LD
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{
"@vocab":"https://data.example.com/ontology#",
"name":"companyName",
"ticker":{"@type":"Ticker"},
"industry":{"@type":"@id"}
},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":"https://data.example.com/industry/q6po09"
}
25 / 46
not just yet another media type
is a standard
playground
in use
Google, BBC, Microsoft, Yandex, etc.
26 / 46
Contextualized data: external context
external context
$GEThttps://data.example.com/general-context.jsonld
Content-Type:application/ld+json
{
"@context":{
"@vocab":"https://data.example.com/ontology#",
"name":"companyName",
"ticker":{"@type":"Ticker"},
"industry":{"@type":"@id"}
}
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
Link:<https://data.example.com/context.jsonld>;rel="http://www.w3.org/ns/json-ld#context"
{
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":"https://data.example.com/industry/q6po09"
} 27 / 46
linking vs embedding
an Industry entity
$GEThttps://data.example.com/industry/q6po09
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Industry",
"name":"Fruits"
}
a Company entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":"https://data.example.com/industry/q6po09"
}
28 / 46
linking vs embedding
a Company entity with its Industry entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":{
"@type":"Industry",
"name":"Fruits"
}
}
29 / 46
deep linking
a Company entity with its Industry entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":{
"@id":"#q6po09",
"@type":"Industry",
"name":"Fruits"
}
}
Now I could use <https://data.example.com/company/c34dap#q6po09>to speak
about the Industryreferenced from the document defining it.
30 / 46
inlining
a Company entity inlining the linked Industry entity
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":{
"@id":"https://data.example.com/industry/q6po09",
"@type":"Industry",
"name":"Fruits"
}
}
remarks
all (or part of) <https://data.example.com/industry/q6po09>'s state is
inlined
the Industry's identity+state is not under this Company's control
could even live on a different domain!
applications could decide to follow links to get authoritative state
31 / 46
Summary so far
started with
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"id":"c34dap",
"name":"Apple",
"ticker":"AAPL",
"industry":"q6po09"
}
32 / 46
Summary so far
started with
$GEThttps://data.example.com/company/c34dap
Content-Type:application/json
{
"id":"c34dap",
"name":"Apple",
"ticker":"AAPL",
"industry":"q6po09"
}
ended up with something like
$GEThttps://data.example.com/company/c34dap
Content-Type:application/ld+json
{
"@context":{...},
"@type":"Company",
"name":"Apple",
"ticker":"AAPL",
"industry":"https://data.example.com/industry/q6po09"
}
33 / 46
Immediate benefits
entities are referenced, embedded and linked together
we get for free provenance and data authority
attributes are disambiguated and can be interrogated
values are typed and can natively be links
vocabularies can be shared, reused and even checked
34 / 46
introducing LDP
Linked Data Platform
intersection of REST and RDF
being specced at W3C for the past 3 years
state-of-the-art of REST APIs
35 / 46
Container model
the usual
$GEThttps://data.example.com/company/
Content-Type:application/json
{
"contains":["https://data.example.com/company/c34dap",...]
}
becomes (introducing the LDP model)
$GEThttps://data.example.com/company/
Content-Type:application/ld+json
Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type"
{
"@context":{
"ldp":"http://www.w3.org/ns/ldp#",
"ldp:contains":{"@container":"@list","@type":"@id"}
},
"@type":["Companies","ldp:BasicContainer"],
"ldp:contains":[
"https://data.example.com/company/c34dap",
...
]
} 36 / 46
Container model + inlining
Container's state + inlined members
$GEThttps://data.example.com/company/
Content-Type:application/ld+json
Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type"
{
"@context":{...},
"@type":["Companies","ldp:BasicContainer"],
"ldp:contains":[
{
"@id":"https://data.example.com/company/c34dap",
"@type":"Company",
"ticker":"AAPL",
"name":"Apple",
"industry":{
"@id":"https://data.example.com/industry/q6po09",
"@type":"Industry",
"name":"Fruits"
}
},
...
]
}
37 / 46
enabling LDP interaction model
rel=type Link header
The "type" link relation can be used to indicate that the context
resource is an instance of the resource identified by the target
Internationalized Resource Identifier (IRI).
in LDP
The presence of this header asserts that the server complies with the
LDP specification's constraints on HTTP interactions with LDPRs, that
is it asserts that the resource has Etags, has an RDF representation,
and so on, which is not true of all Web resources served as RDF media
types.
$HEADhttps://data.example.com/company/
Content-Type:application/ld+json
Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type"
38 / 46
LDP interaction model
resources
Resource (LDPR) ← RDF Source (LDPRS) ← Container (LDPC) ← Basic
Container (Basic Container)
affordance
advertised through rel=typeLink header, not Content-Type
a GET on a container (LDPC) returns its state (ie. its members)
resources (LDPR) are created by POSTing to the container
HTTP 201 Created + Locationheader
use DELETE to remove a member
use PUT to override the state of a member
use PATCH for partial updates
39 / 46
LDP Paging (Working Draft) [1/2]
HTTP 303 See Other
A 303 response to a GET request indicates that the origin server does
not have a representation of the target resource [...] the Location field
value refers to a resource that is descriptive of the target resource
also
server has control over the pagination mechanism
client sets preferences
semantics: snapshot, consistency, etc.
40 / 46
LDP Paging (Working Draft) [2/2]
use Link relations eg. rel='next'
$GEThttps://data.example.com/company/
303SeeOther
Location:https://data.example.com/company/?p=5YjF
$GEThttps://data.example.com/company/?p=5YjF
200OK
Link:<https://data.example.com/company/?p=AyOW>;rel="next"
Content-Type:application/ld+json
{...}
Save a round-trip: HTTP 333 (being standardised)
41 / 46
services
make it discoverable
$HEADhttps://data.example.com/company/
Content-Type:application/ld+json
Link:<https://data.example.com/company/?>;rel="http://data.example.com/api#queryService"
Use Link relation again (not yet standardised)
example
$GEThttps://data.example.com/company/?offset=100&limit=50
42 / 46
ad-hoc service-oriented API [1/2]
$GEThttps://data.example.com/api/getCompaniesByIndustry?industryName="Fruits"
Content-Type:application/ld+json
{
"@context":{...},
"results":[
{"@id":"https://data.example.com/company/c34dap",...},
...
]
}
domain aware
more capabilities
requires to read documentation
return resource URIs and use inlining when needed
43 / 46
ad-hoc service-oriented API [2/2]
microservices
going further
general purpose service-oriented API?
analytics
44 / 46
error handling
LDP servers MUST publish any constraints on LDP clients’ ability to
create or update LDPRs, by adding a Link header with
rel='describedby' [RFC5988] to all responses to requests which fail due
to violation of those constraints. [LDP 4.2.1.2]
so basically, HTTP 4xx + rel='describedby'Link header
use HTTP 400 for application-specific error [LDP ISSUE-98]
for machine readable errors, consider Problem Details for HTTP APIs [http-
problem-06]
45 / 46
to read
HTTP/REST
Web Client Programming with Perl
http://www.slideshare.net/RubenVerborgh/hypermedia-cannot-be-the-
engine
LDP
LDP 1.0 Primer (Editor's Draft)
LDP 1.0 (Editor's Draft)
RDF
http://www.w3.org/TR/2014/REC-turtle-20140225/
http://semanticweb.com/introduction-to-rdf_b17953
http://www.w3.org/TR/2012/REC-rdb-direct-mapping-20120927/
46 / 46

More Related Content

Viewers also liked

Multi criteria queries on a cassandra application
Multi criteria queries on a cassandra applicationMulti criteria queries on a cassandra application
Multi criteria queries on a cassandra application
Ippon
 
Quoi de neuf pour JHipster en 2016
Quoi de neuf pour JHipster en 2016Quoi de neuf pour JHipster en 2016
Quoi de neuf pour JHipster en 2016
Ippon
 
Cassandra Java Driver : vers Cassandra 1.2 et au-delà
Cassandra Java Driver : vers Cassandra 1.2 et au-delàCassandra Java Driver : vers Cassandra 1.2 et au-delà
Cassandra Java Driver : vers Cassandra 1.2 et au-delà
Ippon
 
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
Ippon
 
Démystifions le machine learning avec spark par David Martin pour le Salon B...
Démystifions le machine learning avec spark par David Martin pour le Salon B...Démystifions le machine learning avec spark par David Martin pour le Salon B...
Démystifions le machine learning avec spark par David Martin pour le Salon B...
Ippon
 
Atelier TDD (Test Driven Development)
Atelier TDD (Test Driven Development)Atelier TDD (Test Driven Development)
Atelier TDD (Test Driven Development)
Ippon
 
Formation Gratuite Total Tests par les experts Java Ippon
Formation Gratuite Total Tests par les experts Java Ippon Formation Gratuite Total Tests par les experts Java Ippon
Formation Gratuite Total Tests par les experts Java Ippon
Ippon
 
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
Ippon
 
Agilité, n’oublions pas les valeurs
Agilité, n’oublions pas les valeursAgilité, n’oublions pas les valeurs
Agilité, n’oublions pas les valeurs
Ippon
 
Formation Spring Avancé gratuite par Ippon 2014
Formation Spring Avancé gratuite par Ippon 2014Formation Spring Avancé gratuite par Ippon 2014
Formation Spring Avancé gratuite par Ippon 2014
Ippon
 
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
Ippon
 
Formation Usine Logicielle gratuite par Ippon 2014
Formation Usine Logicielle gratuite par Ippon 2014Formation Usine Logicielle gratuite par Ippon 2014
Formation Usine Logicielle gratuite par Ippon 2014
Ippon
 
Formation html5 CSS3 offerte par ippon 2014
Formation html5 CSS3 offerte par ippon 2014Formation html5 CSS3 offerte par ippon 2014
Formation html5 CSS3 offerte par ippon 2014
Ippon
 
Formation JPA Avancé / Hibernate gratuite par Ippon 2014
Formation JPA Avancé / Hibernate gratuite par Ippon 2014Formation JPA Avancé / Hibernate gratuite par Ippon 2014
Formation JPA Avancé / Hibernate gratuite par Ippon 2014
Ippon
 
Formation GIT gratuite par ippon 2014
Formation GIT gratuite par ippon 2014Formation GIT gratuite par ippon 2014
Formation GIT gratuite par ippon 2014
Ippon
 
JPA avec Cassandra, grâce à Achilles
JPA avec Cassandra, grâce à AchillesJPA avec Cassandra, grâce à Achilles
JPA avec Cassandra, grâce à Achilles
Ippon
 
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et MobileNouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
Ippon
 
La gouvernance de l'information est une affaire de changement - Conférence SE...
La gouvernance de l'information est une affaire de changement - Conférence SE...La gouvernance de l'information est une affaire de changement - Conférence SE...
La gouvernance de l'information est une affaire de changement - Conférence SE...
Perrein Jean-Pascal
 
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
Perrein Jean-Pascal
 
2015 01-camoai transformation-numerique_groupe_offre
2015 01-camoai transformation-numerique_groupe_offre2015 01-camoai transformation-numerique_groupe_offre
2015 01-camoai transformation-numerique_groupe_offre
Jean-Marc Touzard
 

Viewers also liked (20)

Multi criteria queries on a cassandra application
Multi criteria queries on a cassandra applicationMulti criteria queries on a cassandra application
Multi criteria queries on a cassandra application
 
Quoi de neuf pour JHipster en 2016
Quoi de neuf pour JHipster en 2016Quoi de neuf pour JHipster en 2016
Quoi de neuf pour JHipster en 2016
 
Cassandra Java Driver : vers Cassandra 1.2 et au-delà
Cassandra Java Driver : vers Cassandra 1.2 et au-delàCassandra Java Driver : vers Cassandra 1.2 et au-delà
Cassandra Java Driver : vers Cassandra 1.2 et au-delà
 
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
Système d’Information à l’Apec : un nouveau coeur de métier mis en place avec...
 
Démystifions le machine learning avec spark par David Martin pour le Salon B...
Démystifions le machine learning avec spark par David Martin pour le Salon B...Démystifions le machine learning avec spark par David Martin pour le Salon B...
Démystifions le machine learning avec spark par David Martin pour le Salon B...
 
Atelier TDD (Test Driven Development)
Atelier TDD (Test Driven Development)Atelier TDD (Test Driven Development)
Atelier TDD (Test Driven Development)
 
Formation Gratuite Total Tests par les experts Java Ippon
Formation Gratuite Total Tests par les experts Java Ippon Formation Gratuite Total Tests par les experts Java Ippon
Formation Gratuite Total Tests par les experts Java Ippon
 
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
Realtime Web avec Akka, Kafka, Spark et Mesos - Devoxx Paris 2014
 
Agilité, n’oublions pas les valeurs
Agilité, n’oublions pas les valeursAgilité, n’oublions pas les valeurs
Agilité, n’oublions pas les valeurs
 
Formation Spring Avancé gratuite par Ippon 2014
Formation Spring Avancé gratuite par Ippon 2014Formation Spring Avancé gratuite par Ippon 2014
Formation Spring Avancé gratuite par Ippon 2014
 
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
Web API & Cache, the HTTP way - Ippevent 10 Juin 2014
 
Formation Usine Logicielle gratuite par Ippon 2014
Formation Usine Logicielle gratuite par Ippon 2014Formation Usine Logicielle gratuite par Ippon 2014
Formation Usine Logicielle gratuite par Ippon 2014
 
Formation html5 CSS3 offerte par ippon 2014
Formation html5 CSS3 offerte par ippon 2014Formation html5 CSS3 offerte par ippon 2014
Formation html5 CSS3 offerte par ippon 2014
 
Formation JPA Avancé / Hibernate gratuite par Ippon 2014
Formation JPA Avancé / Hibernate gratuite par Ippon 2014Formation JPA Avancé / Hibernate gratuite par Ippon 2014
Formation JPA Avancé / Hibernate gratuite par Ippon 2014
 
Formation GIT gratuite par ippon 2014
Formation GIT gratuite par ippon 2014Formation GIT gratuite par ippon 2014
Formation GIT gratuite par ippon 2014
 
JPA avec Cassandra, grâce à Achilles
JPA avec Cassandra, grâce à AchillesJPA avec Cassandra, grâce à Achilles
JPA avec Cassandra, grâce à Achilles
 
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et MobileNouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
Nouveau look pour une nouvelle vie : HTML5, Spring, NoSQL et Mobile
 
La gouvernance de l'information est une affaire de changement - Conférence SE...
La gouvernance de l'information est une affaire de changement - Conférence SE...La gouvernance de l'information est une affaire de changement - Conférence SE...
La gouvernance de l'information est une affaire de changement - Conférence SE...
 
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
Offre 3org Conseil sur la gouvernance et la gestion de l'information d'entrep...
 
2015 01-camoai transformation-numerique_groupe_offre
2015 01-camoai transformation-numerique_groupe_offre2015 01-camoai transformation-numerique_groupe_offre
2015 01-camoai transformation-numerique_groupe_offre
 

Similar to One Web (API?) – Alexandre Bertails - Ippevent 10 juin 2014

Approaches to machine actionable links
Approaches to machine actionable linksApproaches to machine actionable links
Approaches to machine actionable links
Stephen Richard
 
Hypermedia APIs and HATEOAS
Hypermedia APIs and HATEOASHypermedia APIs and HATEOAS
Hypermedia APIs and HATEOAS
Vladimir Tsukur
 
Introduction to Hydra
Introduction to HydraIntroduction to Hydra
Introduction to Hydra
Alejandro Inestal
 
Semantic web technologies applied to bioinformatics and laboratory data manag...
Semantic web technologies applied to bioinformatics and laboratory data manag...Semantic web technologies applied to bioinformatics and laboratory data manag...
Semantic web technologies applied to bioinformatics and laboratory data manag...
Toni Hermoso Pulido
 
REST based API
REST based APIREST based API
REST based API
ijtsrd
 
Open Calais
Open CalaisOpen Calais
Open Calais
ymark
 
DC-2008 Tutorial 3 - Dublin Core and other metadata schemas
DC-2008 Tutorial 3 - Dublin Core and other metadata schemasDC-2008 Tutorial 3 - Dublin Core and other metadata schemas
DC-2008 Tutorial 3 - Dublin Core and other metadata schemas
Mikael Nilsson
 
Modified REST Presentation
Modified REST PresentationModified REST Presentation
Modified REST Presentation
Alexandros Marinos
 
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
dflejter
 
Building social and RESTful frameworks
Building social and RESTful frameworksBuilding social and RESTful frameworks
Building social and RESTful frameworks
brendonschwartz
 
Hypermedia APIs and HATEOAS / Wix Engineering
Hypermedia APIs and HATEOAS / Wix EngineeringHypermedia APIs and HATEOAS / Wix Engineering
Hypermedia APIs and HATEOAS / Wix Engineering
Vladimir Tsukur
 
Standard Web APIs for Multidisciplinary Collaboration
Standard Web APIs for Multidisciplinary CollaborationStandard Web APIs for Multidisciplinary Collaboration
Standard Web APIs for Multidisciplinary Collaboration
Axel Reichwein
 
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODOLinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
Chris Mungall
 
REST Presentation
REST PresentationREST Presentation
REST Presentation
Alexandros Marinos
 
Linking Media and Data using Apache Marmotta (LIME workshop keynote)
Linking Media and Data using Apache Marmotta  (LIME workshop keynote)Linking Media and Data using Apache Marmotta  (LIME workshop keynote)
Linking Media and Data using Apache Marmotta (LIME workshop keynote)
LinkedTV
 
OpenSearch
OpenSearchOpenSearch
OpenSearch
hchen1
 
Linked Data Planet Key Note
Linked Data Planet Key NoteLinked Data Planet Key Note
Linked Data Planet Key Note
rumito
 
The Social Data Web
The Social Data WebThe Social Data Web
The Social Data Web
George Thomas
 
Gt ea2009
Gt ea2009Gt ea2009
Gt ea2009
George Thomas
 
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
Codemotion
 

Similar to One Web (API?) – Alexandre Bertails - Ippevent 10 juin 2014 (20)

Approaches to machine actionable links
Approaches to machine actionable linksApproaches to machine actionable links
Approaches to machine actionable links
 
Hypermedia APIs and HATEOAS
Hypermedia APIs and HATEOASHypermedia APIs and HATEOAS
Hypermedia APIs and HATEOAS
 
Introduction to Hydra
Introduction to HydraIntroduction to Hydra
Introduction to Hydra
 
Semantic web technologies applied to bioinformatics and laboratory data manag...
Semantic web technologies applied to bioinformatics and laboratory data manag...Semantic web technologies applied to bioinformatics and laboratory data manag...
Semantic web technologies applied to bioinformatics and laboratory data manag...
 
REST based API
REST based APIREST based API
REST based API
 
Open Calais
Open CalaisOpen Calais
Open Calais
 
DC-2008 Tutorial 3 - Dublin Core and other metadata schemas
DC-2008 Tutorial 3 - Dublin Core and other metadata schemasDC-2008 Tutorial 3 - Dublin Core and other metadata schemas
DC-2008 Tutorial 3 - Dublin Core and other metadata schemas
 
Modified REST Presentation
Modified REST PresentationModified REST Presentation
Modified REST Presentation
 
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
Elucidating the Mashup Hype: Definition, Challenges, Methodical Guide and Too...
 
Building social and RESTful frameworks
Building social and RESTful frameworksBuilding social and RESTful frameworks
Building social and RESTful frameworks
 
Hypermedia APIs and HATEOAS / Wix Engineering
Hypermedia APIs and HATEOAS / Wix EngineeringHypermedia APIs and HATEOAS / Wix Engineering
Hypermedia APIs and HATEOAS / Wix Engineering
 
Standard Web APIs for Multidisciplinary Collaboration
Standard Web APIs for Multidisciplinary CollaborationStandard Web APIs for Multidisciplinary Collaboration
Standard Web APIs for Multidisciplinary Collaboration
 
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODOLinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
LinkML Intro July 2022.pptx PLEASE VIEW THIS ON ZENODO
 
REST Presentation
REST PresentationREST Presentation
REST Presentation
 
Linking Media and Data using Apache Marmotta (LIME workshop keynote)
Linking Media and Data using Apache Marmotta  (LIME workshop keynote)Linking Media and Data using Apache Marmotta  (LIME workshop keynote)
Linking Media and Data using Apache Marmotta (LIME workshop keynote)
 
OpenSearch
OpenSearchOpenSearch
OpenSearch
 
Linked Data Planet Key Note
Linked Data Planet Key NoteLinked Data Planet Key Note
Linked Data Planet Key Note
 
The Social Data Web
The Social Data WebThe Social Data Web
The Social Data Web
 
Gt ea2009
Gt ea2009Gt ea2009
Gt ea2009
 
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
David Gómez G. - Hypermedia APIs for headless platforms and Data Integration ...
 

More from Ippon

Offre 2015 numeriq_ippon
Offre 2015 numeriq_ipponOffre 2015 numeriq_ippon
Offre 2015 numeriq_ippon
Ippon
 
CDI par la pratique
CDI par la pratiqueCDI par la pratique
CDI par la pratique
Ippon
 
Hibernate vs le_cloud_computing
Hibernate vs le_cloud_computingHibernate vs le_cloud_computing
Hibernate vs le_cloud_computing
Ippon
 
Stateful is beautiful
Stateful is beautifulStateful is beautiful
Stateful is beautiful
Ippon
 
Présentation Ippon DGA Liferay Symposium 2011
Présentation Ippon DGA Liferay Symposium 2011Présentation Ippon DGA Liferay Symposium 2011
Présentation Ippon DGA Liferay Symposium 2011
Ippon
 
Scrum et forfait
Scrum et forfaitScrum et forfait
Scrum et forfait
Ippon
 
Mule ESB Summit 2010 avec Ippon
Mule ESB Summit 2010 avec IpponMule ESB Summit 2010 avec Ippon
Mule ESB Summit 2010 avec Ippon
Ippon
 
Présentation du retour d'expérience sur Git
Présentation du retour d'expérience sur GitPrésentation du retour d'expérience sur Git
Présentation du retour d'expérience sur Git
Ippon
 
Présentation Rex GWT 2.0
Présentation Rex GWT 2.0Présentation Rex GWT 2.0
Présentation Rex GWT 2.0
Ippon
 
Presentation Rex Methodes Agiles
Presentation Rex Methodes AgilesPresentation Rex Methodes Agiles
Presentation Rex Methodes Agiles
Ippon
 
Seminaire Portail Open Source
Seminaire Portail Open SourceSeminaire Portail Open Source
Seminaire Portail Open Source
Ippon
 

More from Ippon (11)

Offre 2015 numeriq_ippon
Offre 2015 numeriq_ipponOffre 2015 numeriq_ippon
Offre 2015 numeriq_ippon
 
CDI par la pratique
CDI par la pratiqueCDI par la pratique
CDI par la pratique
 
Hibernate vs le_cloud_computing
Hibernate vs le_cloud_computingHibernate vs le_cloud_computing
Hibernate vs le_cloud_computing
 
Stateful is beautiful
Stateful is beautifulStateful is beautiful
Stateful is beautiful
 
Présentation Ippon DGA Liferay Symposium 2011
Présentation Ippon DGA Liferay Symposium 2011Présentation Ippon DGA Liferay Symposium 2011
Présentation Ippon DGA Liferay Symposium 2011
 
Scrum et forfait
Scrum et forfaitScrum et forfait
Scrum et forfait
 
Mule ESB Summit 2010 avec Ippon
Mule ESB Summit 2010 avec IpponMule ESB Summit 2010 avec Ippon
Mule ESB Summit 2010 avec Ippon
 
Présentation du retour d'expérience sur Git
Présentation du retour d'expérience sur GitPrésentation du retour d'expérience sur Git
Présentation du retour d'expérience sur Git
 
Présentation Rex GWT 2.0
Présentation Rex GWT 2.0Présentation Rex GWT 2.0
Présentation Rex GWT 2.0
 
Presentation Rex Methodes Agiles
Presentation Rex Methodes AgilesPresentation Rex Methodes Agiles
Presentation Rex Methodes Agiles
 
Seminaire Portail Open Source
Seminaire Portail Open SourceSeminaire Portail Open Source
Seminaire Portail Open Source
 

Recently uploaded

Build a Professional Resume using Canva , Tanapat Limsaiprom
Build a Professional Resume using Canva , Tanapat LimsaipromBuild a Professional Resume using Canva , Tanapat Limsaiprom
Build a Professional Resume using Canva , Tanapat Limsaiprom
TanapatLimsaiprom1
 
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
samyanvichadda
 
2023. Archive - Gigabajtos selfpublisher homepage
2023. Archive - Gigabajtos selfpublisher homepage2023. Archive - Gigabajtos selfpublisher homepage
2023. Archive - Gigabajtos selfpublisher homepage
Zsolt Nemeth
 
Understanding Threat Intelligence | What is Threat Intelligence
Understanding Threat Intelligence | What is Threat IntelligenceUnderstanding Threat Intelligence | What is Threat Intelligence
Understanding Threat Intelligence | What is Threat Intelligence
Lumiverse Solutions Pvt Ltd
 
6 Reasons to Use a VPN | 3S VPN Server App
6 Reasons to Use a VPN | 3S VPN Server App6 Reasons to Use a VPN | 3S VPN Server App
6 Reasons to Use a VPN | 3S VPN Server App
VPN Server
 
Network Layer and its protocols mod .pptx
Network Layer and its protocols mod .pptxNetwork Layer and its protocols mod .pptx
Network Layer and its protocols mod .pptx
cossykin19
 
Dewanstudio Project Portfolio 2023 show case
Dewanstudio Project Portfolio 2023 show caseDewanstudio Project Portfolio 2023 show case
Dewanstudio Project Portfolio 2023 show case
DEWANSTUDIO.COM
 
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in CityGirls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
dilbaagsingh0898
 
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
mahigarg2024#G05
 
Effective Tips for Creating the Best Rich Media Ads .pptx
Effective Tips for Creating the Best Rich Media Ads .pptxEffective Tips for Creating the Best Rich Media Ads .pptx
Effective Tips for Creating the Best Rich Media Ads .pptx
AirtoryInc
 
UMN degree offer diploma Transcript
UMN degree offer diploma TranscriptUMN degree offer diploma Transcript
UMN degree offer diploma Transcript
cenocb
 
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docxBitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
SFC Today
 
Software Defined Networking, Concepts and Practical Implementations
Software Defined Networking, Concepts and Practical ImplementationsSoftware Defined Networking, Concepts and Practical Implementations
Software Defined Networking, Concepts and Practical Implementations
Bangladesh Network Operators Group
 
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdfHow-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
Dolphin Data Lab
 
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
ffg01100
 
Open Source TCP or Netflow Log Server Using Graylog
Open Source TCP or Netflow Log Server Using GraylogOpen Source TCP or Netflow Log Server Using Graylog
Open Source TCP or Netflow Log Server Using Graylog
Bangladesh Network Operators Group
 
Top 50 Telephone Conversation Sample Examples For IT Industries.pdf
Top 50 Telephone Conversation Sample Examples For IT Industries.pdfTop 50 Telephone Conversation Sample Examples For IT Industries.pdf
Top 50 Telephone Conversation Sample Examples For IT Industries.pdf
Krishna L
 
Trading Strategy for London silver bullet
Trading Strategy for London silver bulletTrading Strategy for London silver bullet
Trading Strategy for London silver bullet
OkgatoSemadi1
 
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptxDraya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
ashishkumarrana9
 
optimized green synthesis characterization and evaluation
optimized green synthesis characterization and evaluationoptimized green synthesis characterization and evaluation
optimized green synthesis characterization and evaluation
ManojKumarr75
 

Recently uploaded (20)

Build a Professional Resume using Canva , Tanapat Limsaiprom
Build a Professional Resume using Canva , Tanapat LimsaipromBuild a Professional Resume using Canva , Tanapat Limsaiprom
Build a Professional Resume using Canva , Tanapat Limsaiprom
 
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
Vip Girls Call ServiCe Chennai X00XXX00XX Tanisha Best High Class Chennai Ava...
 
2023. Archive - Gigabajtos selfpublisher homepage
2023. Archive - Gigabajtos selfpublisher homepage2023. Archive - Gigabajtos selfpublisher homepage
2023. Archive - Gigabajtos selfpublisher homepage
 
Understanding Threat Intelligence | What is Threat Intelligence
Understanding Threat Intelligence | What is Threat IntelligenceUnderstanding Threat Intelligence | What is Threat Intelligence
Understanding Threat Intelligence | What is Threat Intelligence
 
6 Reasons to Use a VPN | 3S VPN Server App
6 Reasons to Use a VPN | 3S VPN Server App6 Reasons to Use a VPN | 3S VPN Server App
6 Reasons to Use a VPN | 3S VPN Server App
 
Network Layer and its protocols mod .pptx
Network Layer and its protocols mod .pptxNetwork Layer and its protocols mod .pptx
Network Layer and its protocols mod .pptx
 
Dewanstudio Project Portfolio 2023 show case
Dewanstudio Project Portfolio 2023 show caseDewanstudio Project Portfolio 2023 show case
Dewanstudio Project Portfolio 2023 show case
 
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in CityGirls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
Girls Call Shimla 000XX00000 Provide Best And Top Girl Service And No1 in City
 
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
Girls Call Mahipalpur 000XX00000 Provide Best And Top Girl Service And No1 in...
 
Effective Tips for Creating the Best Rich Media Ads .pptx
Effective Tips for Creating the Best Rich Media Ads .pptxEffective Tips for Creating the Best Rich Media Ads .pptx
Effective Tips for Creating the Best Rich Media Ads .pptx
 
UMN degree offer diploma Transcript
UMN degree offer diploma TranscriptUMN degree offer diploma Transcript
UMN degree offer diploma Transcript
 
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docxBitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
Bitcoin vs Ethereum Which Crypto Performed Better in Q2, 2024.docx
 
Software Defined Networking, Concepts and Practical Implementations
Software Defined Networking, Concepts and Practical ImplementationsSoftware Defined Networking, Concepts and Practical Implementations
Software Defined Networking, Concepts and Practical Implementations
 
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdfHow-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
How-to-Diagnose-Hard-Drives-by-DFL-DDP-2024.pdf
 
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
202254.com香蕉影视,在线观看《我才不要和你做朋友呢》在线观看最新电影,香蕉影视在线观看《我才不要和你做朋友呢》在线观看高清电影
 
Open Source TCP or Netflow Log Server Using Graylog
Open Source TCP or Netflow Log Server Using GraylogOpen Source TCP or Netflow Log Server Using Graylog
Open Source TCP or Netflow Log Server Using Graylog
 
Top 50 Telephone Conversation Sample Examples For IT Industries.pdf
Top 50 Telephone Conversation Sample Examples For IT Industries.pdfTop 50 Telephone Conversation Sample Examples For IT Industries.pdf
Top 50 Telephone Conversation Sample Examples For IT Industries.pdf
 
Trading Strategy for London silver bullet
Trading Strategy for London silver bulletTrading Strategy for London silver bullet
Trading Strategy for London silver bullet
 
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptxDraya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
Draya Michele’s Son – Kniko Howard’s Rise to Fame.pptx
 
optimized green synthesis characterization and evaluation
optimized green synthesis characterization and evaluationoptimized green synthesis characterization and evaluation
optimized green synthesis characterization and evaluation
 

One Web (API?) – Alexandre Bertails - Ippevent 10 juin 2014

  • 1. Web APIs Alexandre Bertails, Pellucid Analytics @bertails 1 / 46
  • 2. Web APIs Who are the users of my API? What do they do with it? How will they interact with it? 2 / 46
  • 3. Web APIs Who are the users of my API? What do they do with it? How will they interact with it? REST hypermedia HATEOAS 3 / 46
  • 4. HTTP, back to the basics resources representations semantics 4 / 46
  • 5. HTTP interactions $HEADhttps://data.example.com/company/ Content-Type:application/json a media type specification sets out formats processing model hypermedia controls for its representation 5 / 46
  • 6. media type Content-Type and Media Type as defined in HTTPBIS HTTP uses Internet Media Types [RFC2046] in the Content-Type (Section 3.1.1.5) [...] header fields in order to provide open and extensible data typing [...]. Media types define both a data format and various processing models. 6 / 46
  • 7. IANA registry for media types IANA registry for Media Types Name Template Reference json application/json [RFC7158] 7 / 46
  • 8. JSON The JavaScript Object Notation (JSON) Data Interchange Format [RFC7159] JSON can represent four primitive types (strings, numbers, booleans, and null) and two structured types (objects and arrays). 8 / 46
  • 9. JSON The JavaScript Object Notation (JSON) Data Interchange Format [RFC7159] JSON can represent four primitive types (strings, numbers, booleans, and null) and two structured types (objects and arrays). No processing model defined in JSON! (neither in JSON-LD, HAL, etc.) 9 / 46
  • 10. extending media type semantics what wouldthe RESTafarian do? probably use a vendor specific media type $HEADhttps://data.example.com/company/ Content-Type:application/vnd.example.company+json 10 / 46
  • 11. Linkheader rel=profile Link header The 'profile' link relation type [...] allows resource representations to indicate that they are following one or more profiles. A profile is defined not to alter the semantics of the resource representation itself, but to allow clients to learn about additional semantics [...] in addition to those defined by the media type [...]. $HEADhttps://data.example.com/company/ Content-Type:application/json Link:<https://data.example.com/ontology#Company>;rel="profile" 11 / 46
  • 12. HATEOAS? Hypermedia can be the engine of a single API. Hypermedia cannot be the engine of cross-API interactions. Ruben Verborgh, Hypermedia Cannot be the Engine 12 / 46
  • 13. focusing on data HATEOAS is like a hypermedia state machine data modeling is a special case for application state media type encodes kind/type but few missing interactions eg. CRUD 13 / 46
  • 14. data patterns in JSON encodings links types disambiguating schemas Let's make JSON a hypermedia format :-) 14 / 46
  • 15. a 1st version an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "id":"q6po09", "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "id":"c34dap", "name":"Apple", "ticker":"AAPL", "industry":"q6po09" } documentation probably available at something like https://data.example.com/api/documentation 15 / 46
  • 16. things, not String-s an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "@id":"https://data.example.com/industry/q6po09", "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@id":"https://data.example.com/company/c34dap", "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 16 / 46
  • 17. this is its own @id an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 17 / 46
  • 18. what are we dealing with? an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "type":"Industry", "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "type":"Company", "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 18 / 46
  • 19. @type+ URL an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Industry"}, "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Company"}, "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 19 / 46
  • 20. disambiguating attributes [1/3] How to distinguish an industry's name from a company's name? an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Industry"}, "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Company"}, "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 20 / 46
  • 21. disambiguating attributes [2/3] How to distinguish an industry's name from a company's name? an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Industry"}, "https://data.example.com/ontology#industryName":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@type":{"@id":"https://data.example.com/ontology#Company"}, "https://data.example.com/ontology#companyName":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 21 / 46
  • 22. disambiguating attributes [3/3] How to distinguish an industry's name from a company's name? a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@context":{ "name":{"@id":"https://data.example.com/ontology#companyName"} }, "@type":{"@id":"https://data.example.com/ontology#Company"}, "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 22 / 46
  • 23. contextualized data: typed values a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@context":{ "name":{"@id":"https://data.example.com/ontology#companyName"}, "ticker":{"@id":"https://data.example.com/ontology#ticker"}, "industry":{"@id":"https://data.example.com/ontology#industry"} }, "@type":{"@id":"https://data.example.com/ontology#Company"}, "name":"Apple", "ticker":"AAPL", "industry":{"@id":"https://data.example.com/industry/q6po09"} } 23 / 46
  • 24. contextualized data: default vocabulary a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "@context":{ "@vocab":"https://data.example.com/ontology#", "name":"companyName", "ticker":{"@type":"Ticker"}, "industry":{"@type":"@id"} }, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":"https://data.example.com/industry/q6po09" } 24 / 46
  • 26. not just yet another media type is a standard playground in use Google, BBC, Microsoft, Yandex, etc. 26 / 46
  • 27. Contextualized data: external context external context $GEThttps://data.example.com/general-context.jsonld Content-Type:application/ld+json { "@context":{ "@vocab":"https://data.example.com/ontology#", "name":"companyName", "ticker":{"@type":"Ticker"}, "industry":{"@type":"@id"} } } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/json Link:<https://data.example.com/context.jsonld>;rel="http://www.w3.org/ns/json-ld#context" { "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":"https://data.example.com/industry/q6po09" } 27 / 46
  • 28. linking vs embedding an Industry entity $GEThttps://data.example.com/industry/q6po09 Content-Type:application/ld+json { "@context":{...}, "@type":"Industry", "name":"Fruits" } a Company entity $GEThttps://data.example.com/company/c34dap Content-Type:application/ld+json { "@context":{...}, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":"https://data.example.com/industry/q6po09" } 28 / 46
  • 29. linking vs embedding a Company entity with its Industry entity $GEThttps://data.example.com/company/c34dap Content-Type:application/ld+json { "@context":{...}, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":{ "@type":"Industry", "name":"Fruits" } } 29 / 46
  • 30. deep linking a Company entity with its Industry entity $GEThttps://data.example.com/company/c34dap Content-Type:application/ld+json { "@context":{...}, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":{ "@id":"#q6po09", "@type":"Industry", "name":"Fruits" } } Now I could use <https://data.example.com/company/c34dap#q6po09>to speak about the Industryreferenced from the document defining it. 30 / 46
  • 31. inlining a Company entity inlining the linked Industry entity $GEThttps://data.example.com/company/c34dap Content-Type:application/ld+json { "@context":{...}, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":{ "@id":"https://data.example.com/industry/q6po09", "@type":"Industry", "name":"Fruits" } } remarks all (or part of) <https://data.example.com/industry/q6po09>'s state is inlined the Industry's identity+state is not under this Company's control could even live on a different domain! applications could decide to follow links to get authoritative state 31 / 46
  • 32. Summary so far started with $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "id":"c34dap", "name":"Apple", "ticker":"AAPL", "industry":"q6po09" } 32 / 46
  • 33. Summary so far started with $GEThttps://data.example.com/company/c34dap Content-Type:application/json { "id":"c34dap", "name":"Apple", "ticker":"AAPL", "industry":"q6po09" } ended up with something like $GEThttps://data.example.com/company/c34dap Content-Type:application/ld+json { "@context":{...}, "@type":"Company", "name":"Apple", "ticker":"AAPL", "industry":"https://data.example.com/industry/q6po09" } 33 / 46
  • 34. Immediate benefits entities are referenced, embedded and linked together we get for free provenance and data authority attributes are disambiguated and can be interrogated values are typed and can natively be links vocabularies can be shared, reused and even checked 34 / 46
  • 35. introducing LDP Linked Data Platform intersection of REST and RDF being specced at W3C for the past 3 years state-of-the-art of REST APIs 35 / 46
  • 36. Container model the usual $GEThttps://data.example.com/company/ Content-Type:application/json { "contains":["https://data.example.com/company/c34dap",...] } becomes (introducing the LDP model) $GEThttps://data.example.com/company/ Content-Type:application/ld+json Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type" { "@context":{ "ldp":"http://www.w3.org/ns/ldp#", "ldp:contains":{"@container":"@list","@type":"@id"} }, "@type":["Companies","ldp:BasicContainer"], "ldp:contains":[ "https://data.example.com/company/c34dap", ... ] } 36 / 46
  • 37. Container model + inlining Container's state + inlined members $GEThttps://data.example.com/company/ Content-Type:application/ld+json Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type" { "@context":{...}, "@type":["Companies","ldp:BasicContainer"], "ldp:contains":[ { "@id":"https://data.example.com/company/c34dap", "@type":"Company", "ticker":"AAPL", "name":"Apple", "industry":{ "@id":"https://data.example.com/industry/q6po09", "@type":"Industry", "name":"Fruits" } }, ... ] } 37 / 46
  • 38. enabling LDP interaction model rel=type Link header The "type" link relation can be used to indicate that the context resource is an instance of the resource identified by the target Internationalized Resource Identifier (IRI). in LDP The presence of this header asserts that the server complies with the LDP specification's constraints on HTTP interactions with LDPRs, that is it asserts that the resource has Etags, has an RDF representation, and so on, which is not true of all Web resources served as RDF media types. $HEADhttps://data.example.com/company/ Content-Type:application/ld+json Link:<http://www.w3.org/ns/ldp#BasicContainer>;rel="type" 38 / 46
  • 39. LDP interaction model resources Resource (LDPR) ← RDF Source (LDPRS) ← Container (LDPC) ← Basic Container (Basic Container) affordance advertised through rel=typeLink header, not Content-Type a GET on a container (LDPC) returns its state (ie. its members) resources (LDPR) are created by POSTing to the container HTTP 201 Created + Locationheader use DELETE to remove a member use PUT to override the state of a member use PATCH for partial updates 39 / 46
  • 40. LDP Paging (Working Draft) [1/2] HTTP 303 See Other A 303 response to a GET request indicates that the origin server does not have a representation of the target resource [...] the Location field value refers to a resource that is descriptive of the target resource also server has control over the pagination mechanism client sets preferences semantics: snapshot, consistency, etc. 40 / 46
  • 41. LDP Paging (Working Draft) [2/2] use Link relations eg. rel='next' $GEThttps://data.example.com/company/ 303SeeOther Location:https://data.example.com/company/?p=5YjF $GEThttps://data.example.com/company/?p=5YjF 200OK Link:<https://data.example.com/company/?p=AyOW>;rel="next" Content-Type:application/ld+json {...} Save a round-trip: HTTP 333 (being standardised) 41 / 46
  • 43. ad-hoc service-oriented API [1/2] $GEThttps://data.example.com/api/getCompaniesByIndustry?industryName="Fruits" Content-Type:application/ld+json { "@context":{...}, "results":[ {"@id":"https://data.example.com/company/c34dap",...}, ... ] } domain aware more capabilities requires to read documentation return resource URIs and use inlining when needed 43 / 46
  • 44. ad-hoc service-oriented API [2/2] microservices going further general purpose service-oriented API? analytics 44 / 46
  • 45. error handling LDP servers MUST publish any constraints on LDP clients’ ability to create or update LDPRs, by adding a Link header with rel='describedby' [RFC5988] to all responses to requests which fail due to violation of those constraints. [LDP 4.2.1.2] so basically, HTTP 4xx + rel='describedby'Link header use HTTP 400 for application-specific error [LDP ISSUE-98] for machine readable errors, consider Problem Details for HTTP APIs [http- problem-06] 45 / 46
  • 46. to read HTTP/REST Web Client Programming with Perl http://www.slideshare.net/RubenVerborgh/hypermedia-cannot-be-the- engine LDP LDP 1.0 Primer (Editor's Draft) LDP 1.0 (Editor's Draft) RDF http://www.w3.org/TR/2014/REC-turtle-20140225/ http://semanticweb.com/introduction-to-rdf_b17953 http://www.w3.org/TR/2012/REC-rdb-direct-mapping-20120927/ 46 / 46