Öffentliche Beispiel REST Web Services

REST API mit JSON und Swagger

Das Fruit Shop API wurde nach REST Design Prinzipien erstellt und soll als Vorlage für RESTful Design dienen. Die API ist mit Swagger UI beschrieben und bietet eine Swagger UI Oberfläche an. Benutzer können nicht nur Abfragen mit GET durchführen. Über POST, PUT und DELETE dürfen die Daten des APIs auch gerne verändert werden. Für die Änderungen sind keine Zugangsdaten notwendig. Trauen Sie sich POST und PUT zu verwenden, wir setzen die Daten des API regelmäßig zurück.

Beispiele für POST, PUT und PATCH findest du hier.

REST API mit XML

Diese Online Anwendung dient als Beispiel für einen RESTful Web Service. Der Service baut auf den Prinzipien des REpresentational State Transfer Architektur Stils auf. Er repräsentiert eine relationale Datenbank als Web Service. In dieser Demo haben wir die Beispieldatenbank des Hypersonic DBMS verwendet. Tabellen und Datensätze werden als Resourcen abgebildet.
Die Resourcen können mittels HTTP und XML abgefragt, gelöscht und verändert werden. Eine Manipulation der Resourcen bewirkt auch eine Veränderung in der Datenbank. Für die Kommunikation mit dem Service kann ein Browser wie der Firefox oder der Internet Explorer verwendet werden.

REST Web Service Demo

Beispiele

Der Web Service kann unter Nutzung der Verlinkungen erkundschaftet werden. Wenn man den XLink Attributen folgt gelangt man von einer Resource zur nächsten. Kopieren Sie einfach die Links und fügen Sie sie im Adressfeld des Browsers wieder ein.

Der Web Service
http://www.thomas-bayer.com/sqlrest/

Kunde # 18
http://www.thomas-bayer.com/sqlrest/CUSTOMER/18/

Auflistung der Rechnungen
http://www.thomas-bayer.com/sqlrest/INVOICE/

Man erkennt schnell selbst, dass man lediglich den ersten Link benötigt, um durch den gesamten Service zu navigieren. Um die Anwendung noch detaillierter zu studieren kann man RESTGate benutzen, womit man POST, PUT und DELETE Anfragen über den Browser absenden kann.

Daten Manipulation

Eine andere Möglichkeit die Daten zu bearbeiten bietet das RESTian Interface. Unter Benutzung der POST, PUT und DELETE Methoden können Resourcen verändert, kreiert und gelöscht werden. Scheuen Sie sich nicht davor den Inhalt des Services zu verändern, aber löschen Sie bitte nicht alles.

Um POST, PUT oder DELETE Nachrichten zu verschicken, müssen Sie ein Skript schreiben oder ein Tool verwenden. Wie man den Web Service benutzt ist im 15 Minuten Guide zu sqlREST beschrieben.

Veröffentlichen Sie Ihre eigene Datenbank als REST Service

Das Online Beispiel nutzt das sqlREST Projekt, welches man auf sourceforge findet. sqlREST ist eine Java EE Web Applikation, die mit jeder beliebigen JDBC Datenbank konfiguriert werden kann. Das Programm beinhaltet eine hsql Datenbank, aber es läuft genauso gut mit Datenbanken wie MySql, MS SQL Server oder Oracle. Um sqlREST zu installieren wird lediglich ein Web Container wie Tomcat oder Jetty benötigt.

Quellen

Architectural Styles and the Design of Network-based Software Architectures
Dissertation von Thomas Roy Fielding

RESTwiki
Wiki Web zu REST

REST Web Services - Eine Einführung
Eine Einführung in REpresentational State Transfer

Share

REST API Schulungen

Lerne die Ideen und Prinzipien von REST, verbessere dein API Design oder erfahre, wie Du API mit TLS und OAuth2 absicherst.