PM22 - Technologie Erklärt: APIs mit Frank Schmidt

Technologie Erklärt: APIs mit Frank Schmidt

In dieser Episode geht es um:

• Was ist eine API? (01:16)
• Wie werden APIs genutzt? (06:10)
• Was unterscheidet eine Rest API von einem einfach CSV Export? (09:25)
• Was ist der Unterschied zwischen API Endpunkten und Standards? (18:27)
• Wie geht ein Entwickler an eine API heran? (22:59)
• API First! (26:18)
• Die klassischen Anwendungsfälle einer API (33:35)
• Die Zukunft der APIs (42:40)

Was ist eine API? (01:16)

Eine API ist ganz einfach gesprochen eine Schnittstelle zwischen zwei Computern. Also sie schafft die Möglichkeit, dass sich zwei Systeme miteinander unterhalten und Daten austauschen können. Das Pendant aus unserem Alltag ist die grafische Benutzeroberfläche, also die Schnittstelle zwischen Mensch und Computer. Wenn wir bei Ingenious über APIs sprechen, dann meinen wir häufig Web-APIs bzw. Rest-APIs: Schnittstellen, die dafür gedacht sind, dass Systeme über das Internet miteinander kommunizieren. Warum arbeitet man mit APIs? In den meisten Fällen arbeiten wir einfach nur mit der grafischen Benutzeroberfläche. Bestimmte Tätigkeiten wiederholen sich häufig und/oder sind sehr aufwändig, weshalb man sie nicht per Hand machen will und stattdessen Automatismen aufbauen. Dafür eignen sich APIs sehr gut. Ein Beispiel dafür aus unserer Branche ist der Prozess der Sales Validierung: über das Tracking wurden Sales erfasst und diese sollen nun validiert werden. Der Advertiser hat in seinem System eine Art von nötiger Bestätigung eingebaut, dass dieser Einkauf nun valide ist (z.B. Rückgabezeitraum ist abgelaufen). Jetzt ist der Kauf bestätigt und der Partner soll die Vergütung dafür erhalten. Dieser Validierungsprozess wird vor allem bei großen Shops aufgrund des enormen Aufwands automatisiert.

Wie werden diese APIs genutzt? (06:10)

Die (manuelle) Nutzung einer API ist nicht ganz einfach. Das ist allerdings kein Problem, da APIs ja primär dafür gedacht sind, dass Systeme miteinander arbeiten und nicht, dass ein Mensch mit einbezogen muss. Häufig wird bei der Verwendung von APIs nicht mit Dateiformaten, die gut (für Menschen) verständlich sind, gearbeitet. Während wir oft mit Excel oder CSV Dateien arbeiten, sind die Dateiformate, über die APIs kommunizieren, sehr viel komplexer und für Menschen schwer lesbar.

Was unterscheidet eine Rest-API von einem einfach CSV Export? (09:25)

Rest-APIs arbeiten mit strukturierten Objekten. Strukturiert bedeutet in der Excel Welt, dass jede Eigenschaft eines Objekts eine Zelle erhält. Erklärung anhand eines Beispiels unserer Branche: Eine Conversion kann aus einem Warenkorb bestehen, der wiederum aus mehreren Produkten bestehen kann. Bei einer Darstellung in einer Exceltabelle wäre die Conversion eine Zeile und die Spalten die jeweiligen Eigenschaften der Conversion wie z.B. der Warenkorb. Der Warenkorb hat allerdings ebenso Eigenschaften und hätte damit auch eigene Spalten. In einem JSON Dokument (das von Rest-APIs genutzte Dateiformat) kann diese Mehrdimensionalität von Conversions abgebildet werden: beliebig viele strukturierte Objekte können in einem strukturierten Objekt enthalten sein (vgl. Unterkapitel in einer Gliederung).

Was ist der Unterschied zwischen API Endpunkten und Standards? (18:27)

Ein Endpunkt beschreibt eine Operation/Aktion (z.B. abrufen, verändern, löschen) auf einem bestimmten Datenmodell (z.B. Conversion oder Advertiser). Standards beschreiben die Form, in der Dinge aussehen bzw. Ablaufen müssen, sodass ein einheitliches Format bzw. Sprache vorliegt.

Wie geht ein Entwickler an eine API heran? (22:59) Häufig kommt der Auftrag einer Automatisierung von einer anderen Abteilung als der der EntwicklerInnen. Im optimalen Fall mit Zugriff zum User Account,