Das leichtgewichtige Python-Framework Flask verfolgt einen minimalistischen Ansatz und eignet sich mit kurzen Reaktionszeiten gut für Microservices und Programmierschnittstellen. RESTful APIs haben sich mittlerweile als Standard für die Kommunikation unter Maschinen durchgesetzt. Dieser Artikel zeigt, wie Sie solche Interfaces mit Flask aufsetzen können, inklusive objektrelationaler Datenbankanbindung mit SQLAlchemy.
Programmierschnittstellen spielen heutzutage eine große Rolle im Internet. Neben der normalen Benutzung über Seiten im Browser wird mittlerweile zu jedem guten Web-Service ein API (Application Programming Interface) angeboten, über das Anwender alternativ auf Angebote zugreifen können. Das ist zum Beispiel der Fall bei Twitter, Wikipedia, GitHub, DigitalOcean und vielen anderen, und auch CMS-Systeme wie WordPress lassen sich über externe Schnittstellen ansprechen und nutzen. Andere Services wie zum Beispiel Amazons Objektspeicher S3 sind als Geschäftsmodell direkt als API aufgesetzt. Auch wenn es nicht ausgeschlossen ist, sind diese als Interface aufgesetzten Zugangslösungen eigentlich nicht für den händischen Gebrauch mit bestimmten Standardwerkzeugen gedacht, sondern dienen vor allem dazu, mittels speziell dafür geschriebener Software angesprochen zu werden. Die angebotenen APIs richten sich dabei vor allem an Entwickler von Endanwenderlösungen, um für den verfügbaren Service speziell konfektionierte Applikationen herzustellen oder in eigene Angebote wie etwa Metaportale zu integrieren. Prinzipiell steht es dabei aber jedem Benutzer offen, sich selbst Programme zu schreiben mit denen er APIs anzapft um Daten auszulesen oder zu schreiben, und die für ein Webportal erworbene Zugangsberechtigung gilt meistens auch für diesen alternativen Kommunikationsweg. Die Anbieter von Web Services auf der anderen Seite sind vor allem aber daran interessiert, welche Mittel gut dafür geeignet sind, um ein API aufzusetzen und zur Verfügung zu stellen.
Der Standard für Programmierschnittstellen, der seit einigen Jahren verstärkt eingesetzt wird und der sich neben Konkurrenten wie SOAP und XML-RPC mittlerweile durchgesetzt hat, ist REST (Representational State Transfer) [1]. Bei dem im Jahr 2000 entwickelten REST handelt es sich aber nicht um eine Spezifikation, sondern um eine Richtlinie beziehungsweise ein Designprinzip für die Kommunikation von Maschinen, das gut oder schlecht umgesetzt werden kann (im Englischen gibt es dafür den Ausdruck „RESTfulness“). Der theoretische Hintergrund von RESTful APIs ist ein Thema für sich, denn es handelt sich um einen abstrakten Architekturstil, der eine konkrete Implementierung eigentlich nicht vorgibt, und die jeweilige Anwendungslogik muss von Entwicklern selbst auf die REST-Prinzipien abgebildet werden. In der Praxis bedeutet das, zwischen den bei einem Service beteiligten Komponenten eine zusätzliche Schicht einzufügen, die unabhängig von der spezifischen Infrastruktur als Abstraktionsebene funktioniert. Für den API-Endanwender spielt es dann keine Rolle, wie das Schnittstellen-Backend technisch realisiert ist. Als Grundlage für die Umsetzung der im Hintergrund stehenden Prinzipien setzen RESTful APIs als Web Services konkret auf das bewährte, zustandslose Webprotokoll HTTP und machen sich dessen Eigenschaften wie die eingebauten Statuscodes zunutze. In Bezug auf Datensätze werden die HTTP-Methoden POST, GET, PUT/PATCH und DELETE verwendet, um die Elemente des CRUD-Zyklus (Create, Read, Update, Delete) umzusetzen. Dabei werden Ressourcen im allgemeinen Sinn, wie zum Beispiel Datenbankeinträge, als eindeutige Webadressen zur Verfügung gestellt (etwa http://beispiel.de/rechnungen/2018/07), die Sie mit beliebigen HTTP-Klienten wie curl oder HTTPie ansprechen und manipulieren können. Bei einem RESTful API liegt der Fokus auf den repräsentierten Objekten und das Interface erklärt sich dabei praktisch selbst – und das ist, alles in allem, ein attraktives Konzept mit vielen positiven Effekten. So können sich z. B. externe Entwickler und neue Mitarbeiter schnell in die damit umgesetzte Anwendungslogik einarbeiten.
Flask
Bei Flask [2] („Fläschchen“) handelt es sich um ein BSD-lizenziertes Framework für Python, mit dem Sie beliebige Webapplikationen schreiben können [3]. Anders als sein „großer Bruder“, das Python-Webframework Django, ist Flask auf Minimalität ausgelegt: Es wird nicht automatisch immer eine Datenbank benötigt, und es gibt nur wenige Grundabhängigkeiten, zu denen das WSGI-Toolkit „Werkzeug“ gehört und die Template-Engine Jinja2, mit der das Framework dynamische HTML-Seiten rendert. Für ausgewachsene Webapplikationen steht für Flask eine ganze Reihe von Erweiterungspaketen zur Verfügung, wie etwa eine Administrationsoberfläche und ein Benutzermanagement, Anbindungen an SQL- und NoSQL-Datenbanken, Pakete für Twitter Bootstrap, WTForms, Bcrypt und vieles mehr. Der minimalistische Grundansatz als „Mikroframework“ und die daraus resultierenden schnellen Reaktionszeiten prädestinieren Flask aber geradezu dafür, damit Microservices [4] und Webinterfaces [5] aufzusetzen. Flask ist als Python-Bibliothek implementiert und Sie können es über die üblichen Wege auf den Arbeitsrechner bekommen: als Paket für Ihre Linux-Distribution, über den Python Package Index, direkt aus dem Code-Repository bei GitHub [6], oder auf noch anderen Wegen. Ein minimales Beispiel (Listing 1) verdeutlicht, wie Flask angewendet wird. Gegenüber dem üblichen statischen „Hello, World!“-Beispiel hier direkt eine kleine Applikation, die dynamische Endpunkte und GET-Argumente vom Klienten auswertet.
Importieren Sie zunächst die benötigten Komponenten...

