RESTing on HTTP

RESTING ON HTTP
DEVELOPER WEEK - 17.06.2015

WHO AM I?
Maximilian Berghoff
Mayflower GmbH (Würzburg)
@ElectricMaxxx
Maximilian.Berghoff@mayflower.de

GET /info HTTP/1.1
Host: www.expamle.dev
ContentType: text/html
Header Request

<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF8">
<title>Information</title>
</head>
<body>
<h1>Information about this page</h1>
Here you will get your information
</body>
</html>
Content der Response

HTTP/1.1 200 OK
ContentType: text/html; charset=UTF8
..

Header Response

STATUS CODES
1XX - Bearbeitung dauert an (Intermediate)
2XX - Anfrage Erfolgreich
3XX - Umleitungen
4XX - Fehler in der Anfrage/beim Client
5XX - Fehler am Server

POST /users HTTP/1.1
Host: www.example.dev
ContentType: application/json
{
    "firstName": "Max",
    "lastName": "Berghoff"
}

POST request

HTTP/1.1 201 Created
ContentType: application/json;
ContentLocation: /users/3
{
    "id": "3",
    "firstName": "Max",
    "lastName": "Berghoff"
}

POST response

PUT /users/3 HTTP/1.1
ContentType: application/json
{
    "firstName": "Max",
    "lastName": "Berghoff",
    "email": "Maximilian.Berghoff@mayflower.de"
}

PUT request

HTTP/1.1 200 OK
ContentType: application/json;
{
    "id": "3",
    "firstName": "Max",
}

POST response

DELETE /users/3 HTTP/1.1
DELETE request

HTTP/1.1 204 No Content
Location: /users
DELETE response

ROY FIELDING
HTTP Spezification

DISERTATION
ARCHITECTURAL STYLES AND THE DESIGN OF NETWORK-BASED SOFTWARE ARCHITECTURES
DOCTOR OF PHILOSOPHY, 2000

JEDE INFORMATION KANN
RESOURCE SEIN
(HTML) Dokument
Bild
Liste von Resourcen
Alles was Ziel einer Referenz/eines Link sein kann.

{
    "userId": "3",
    "username": "ElectricMaxxx",
    "firstName": "Max",
}
User als JSON

<user>
 <userId>3</userId>
 <userName>ElectricMaxxx</userName>
 <firstName>Maximilian</firstName>
 <lastName>Berghoff</lastName>
 <email>Maximilian.Berghoff@gmx.de</email>
</user>
User als XML

<ul>
 <li>
 Username: ElectricMaxxx
 </li>
 <li>
 FirstName: Max
 </li>
 <li>
 LastName: Berghoff
 </li>
 <li>
 Email: Maximilian.Berghoff@mayflower.de
 </li>
</ul>
User als HTML in einem Profil

WIE ERHALTE ICH DIE
GEWÜNSCHTE
REPRÄSENTATION?

IN DER URL
/users/3.json
Oder /users/3.xml
Oder /users/3.html

IM HEADER
GET /users/3
Content-Type: application/json
Oder Content-Type: application/xml
Oder Content-Type: text/html

HYPERMEDIA
AS THE ENGINE OF
APPLICATION STATE

<?xml version="1.0"?>
<user>
 <link rel="groups" href="/users/3/groups" />
 <link rel="roles" href="/users/3/roles" />
 <link rel="orders" href="/users/3/orders" />
</user>

"_links":{
    "self": { "href": "/users/3" }
},
"userId": "3",
"_embedded": {
    "orders": [{
        "_links": {
            "self": { "href": "users/3/orders/123"}
        }
    }],
    "groups": [{
        "_links": {
            "self": { "href": "users/3/orders/2"}
        }
    }]
}

GET /users/3 HTTP/1.1
Host: www.expamle.dev
ContentType: application/xml
Request auf User mit der ID 3

HTTP/1.1 200 OK
ContentType: application/xml
<?xml version="1.0"?>
<user>
 <link rel="groups" href="/users/3/groups" />
 <link rel="roles" href="/users/3/roles" />
 <link rel="orders" href="/users/3/orders" />
</user>

Anwort des Services in XML

CONTRAINTS ERFÜLLT
-> REST = HTTP?

REPRESENTATIONAL
STATE TRANSFER

QUESTIONS ?
Ask now!
Twitter: @ElectricMaxxx
Mail: Maximilian.Berghoff@mayflower.de

RESTing on HTTP

More Related Content

Viewers also liked (20)

Similar to RESTing on HTTP (20)

More from Maximilian Berghoff (20)

Recently uploaded (20)

RESTing on HTTP