Mit einer gut gemachten API können sich Anbieter von den Produkten ihrer Konkurrenz abheben und erfolgreicher am Markt sein. Um APIs gut zu gestalten, sind die richtige Herangehensweise und einige Anpassungen im Unternehmen nötig.

Im vorangegangen Blog-Artikel (APIs für Produkte der nächsten Generation) haben wir festgestellt, dass APIs nicht nur ein technisches Detail im Aufgabenbereich der IT-Abteilung sind, sondern zu einem wesentlichen Bestandteil eines Service geworden sind, der dem Kunden angeboten wird, und dass sie als Teil des Produkts ebenfalls ein professionelles Product Management benötigen.

Damit diese APIs erfolgreich sind, müssen sie mit der richtigen Mentalität (engl. Mindset) entworfen und gepflegt werden:

Produktmanager sind im Lead

APIs müssen als Teil des Produkts gemanagt werden. Entsprechend sind Produktmanager in der Verantwortung festzulegen, was die API leisten wird. Grundlage für diese Entscheide sind Analysen der Kundenbedürfnisse und des Marktes.

Kern der API-Economy sind die Entwickler

APIs sollen die Bedürfnisse der API-Anwender treffen, also der IT-Mitarbeiter des Kunden, und vor allem dessen Entwickler. Eines ihrer wesentlichen Bedürfnisse besteht darin, APIs schnell und mit niedrigen Implementierungskosten einsetzen zu können. Produktmanager müssen sich also in die Situation der IT-Leute versetzen, wenn sie APIs und die dazugehörigen Hilfsmittel entwerfen. Es braucht dazu das Bewusstsein über die Wichtigkeit einer leicht verständlichen API, professioneller Dokumentation, guter Beispiele und einer Sandbox (Umgebung) für Tests. Nicht umsonst wurde der Begriff der "Developer Experience" geprägt.

Developer Experience = Customer Experience

Aus dieser Perspektive leuchtet es auch ein, dass die IT allein nicht genügt, um gute APIs zu schaffen. So wie man auch in anderen IT-Projekten UX Designer für User Interface, Technical Writer fürs Handbuch usw. beizieht, sind ähnliche Spezialisten für APIs gefragt.

Testing, Testing, Testing

Ob eine gute Developer Experience erreicht wird und ob die API in der vorgeschlagenen Form für die ganze Zielgruppe passt, lässt sich aufgrund des API Designs allein nicht sagen. Dazu sind Tests nötig. Möglich sind sowohl interne Tests als auch die Begleitung der ersten API-Anwender.

Wir erleben es bei Firmen, dass es etwas Neues ist, APIs auch ausserhalb der IT-Abteilung zu thematisieren und als wesentlichen Teil des Produkts zu behandeln. Product Manager sollen sich plötzlich mit einem vermeintlich technischen Thema beschäftigen, allerdings sind die benötigten Skills noch nicht vorhanden. Die Zusammenarbeit und Arbeitsteilung mit der IT-Abteilung birgt Konfliktpotenzial.

Neues Mindset

Kurz: Es ist eine neue Herausforderung und bedingt einen Kulturwandel in der Firma.

Um ein neues Mindset für die neue Herangehensweise an APIs im Unternehmen zu verankern, sollten umfassende Massnahmen getroffen werden:

• Es wird bestimmt, welche Produktmanager für APIs verantwortlich sind. Im Product Management Team wird das nötige API-Knowhow aufgebaut.
• Die Verantwortlichkeiten bei der Implementierung von APIs werden definiert: Welche Aufgaben haben der/die Product Manager, welche die IT-Abteilung? Welche Spezialisten (Technical Writer, API Designer etc.) werden in der Regel beigezogen?
• Richtlinien und Anleitungen werden erstellt, die helfen APIs zu entwerfen, die konsistent gestaltet und dokumentiert sind.
• Eine Qualitätssicherung für APIs und dabei insbesondere für das API-Design wird etabliert. Damit wird sichergestellt, dass ein API vor der Veröffentlichung auf gute Verständlichkeit, einfache Nutzbarkeit und Eignung für die Zielgruppe eingehend geprüft wird. Mangelhafte und ungeeignete APIs werden entsprechend nicht live gesetzt.
• Die API-Awareness wird mit Informationsveranstaltungen und weiteren Kommunikationsmassnahmen über die unmittelbar involvierten Personen hinaus verbreitert.
• Durch die rasche Umsetzung einer ersten API werden Erfahrungen gesammelt und der Lernprozess im Unternehmen beschleunigt.

Fazit

Werden APIs nicht systematisch verwaltet, so entsteht in kürzester Zeit ein API-Dschungel mit Inkonsistenzen, unnötiger Komplexität und fehlender Dokumentation. Das führt unweigerlich dazu, dass eine API wenig genutzt wird, aber teuer in der Bereitstellung und im Unterhalt ist. Somit erleidet man mit der API Schiffbruch auf der ganzen Linie.

Die Herausforderungen sind dabei in der Regel nicht technischer Natur. Die Technik ist vorhanden, und die IT-Abteilung beherrscht sie. Im Fokus steht stattdessen, ein API-Mindset zu etablieren: APIs zum Business-Thema machen, organisatorische Anpassungen vornehmen, und gutes Teamwork zwischen Business und IT etablieren.

Mit den vorgeschlagenen Massnahmen sollte dies gelingen, sodass APIs zu einem Erfolgsfaktor der Dienstleistungen und des Unternehmens werden.

‍