Some brief intro to REST as paradigm for building Web services (in German)

1. REST-konforme
Schnittstellen für
Web Services

2. Remote Procedure Call
CORBA
Remote Method Invocation
XML-RPC SOAP
Thrift

3. REST

4. REST ist eine Architektur
HTTP ist eine konkrete
Implementierung davon

5. Ressourcen
http://www.mybank.com/accounts/
http://www.mybank.com/accounts/4582
http://www.mybank.com/accounts/4582/statements/
http://www.mybank.com/accounts/4582/statements/latest
http://www.mybank.com/accounts/4582/transfers
http://www.mybank.com/accounts/4582/transfers/12
http://www.mybank.com/accounts/4582/transfers/12?from=...&to=...
http://www.mybank.com/accounts/4582/transfers/12/recipient

6. Repräsentationen
{ „account“ : {
„id“ : 4582,
„firstName“ : „Singh“,
„lastName“ : „Darshan“,
„balance“ : 25382.20,
„openDate“ : „2002-02-20“ }
}
<?xml version=“1.0“?>
<account>
<id>4582</id>
<firstName>Singh</firstName>
<lastName>Darshan</lastName>
<balance>25382.20</balance>
<openDate>2002-02-20</openDate>
</account>

7. 4 Operationen
GET
POST
PUT
DELETE

8. 4 Operationen
safe?
GET
POST
PUT
DELETE

9. 4 Operationen
safe? idempotent?
GET
POST
PUT
DELETE

10. Hypermedia
Person
Transfer Person
Account
Statement
Balance

11. Zustandslose Kommunikation
Keine Sessions
Keine Cookies
Jede Anfrage enthält alle Informationen, die der
Server für die Verarbeitung benötigt.

12. REST ist nur
ein Paradigma

13. Häufige „Fehler“

14. RPC Stil
http://www.mybank.com/accounts/4582?
action=transfer&dest=9811&amount=100

15. POST Tunneling
http://www.mybank.com/accounts?
action=close&id=4582

16. Vermischung Ressource
und Repräsentation
GET /accounts/4982.json?apikey=912864
GET /accounts/4982
Accept: application/json
X-apikey: 912864

17. Keine Links
{ „account“ :
{
„id“ : 4582,
„firstName“ : „Singh“,
„lastName“ : „Darshan“,
„balance“ : 25382.20,
„openDate“ : „2002-02-20“
}
}

18. Nur interne IDs
{ „account“ :
{
„id“ : 4582,
„owner“ : 56120,
„balance“ : 25382.20,
„openDate“ : „2002-02-20“
}
}

19. Keine Links zu
Sub-Ressourcen
{ „account“ :
{
„id“ : 4582,
„owner“ : „http//www.mybank.com/clients/561202“,
„balance“ : 25382.20,
„openDate“ : „2002-02-20“
}
}

20. Korrekt:
{ „account“ :
{
„id“ : 4582,
„owner“ : „http//www.mybank.com/clients/561202“,
„statements“ : „http://www.mybank.com/accounts/
4582/statements“,
„transfers“ : „http://www.mybank.com/accounts/
4582/transfers“,
„balance“ : 25382.20,
„openDate“ : „2002-02-20“
}
}

21. HTTP Status Codes
GET /accounts/4982
HTTP/1.1 200 OK
Content-Type: application/json
{ „error:
{ „code“ : 491,
„message“ : „Not authorized“ } }

22. Zusammenfassung
• Wichtiges Paradigma für moderne APIs
• REST ist offen für Interpretationen
• Entwicklungsframeworks helfen nur wenig