Wie ein API-first-Ansatz die Zukunft von Zonos gestaltet

Was ist ein API-first-Ansatz? 

Der API-first-Ansatz steht in starkem Kontrast zum Code-first-Ansatz, bei dem ein Team zuerst die Funktionalität der Anwendung entwirft, den Code schreibt und APIs erst am Ende des Prozesses hinzufügt.

Bei Zonos bedeutet Softwareentwicklung mit einem API-first-Ansatz, Lösungen um eine API herum zu entwerfen, statt eine Anwendung zu programmieren und später eine API hinzuzufügen. Das bedeutet, unsere APIs sind von zentraler Bedeutung und Produkte für sich; wir entwerfen sie mit intensivem Fokus auf die Bedürfnisse der Kunden und dokumentieren und architektieren sie klar, bevor wir Code schreiben.

Die Vorteile eines API-first-Ansatzes 

Der API-first-Ansatz hilft, folgende Denkweise zu etablieren:

• Wir verstehen, dass unsere APIs die primäre Schnittstelle für unsere Kunden sind, und betrachten sie daher als unsere öffentlichen Liefergegenstände.
• Dokumentation vor dem Schreiben von Code gibt uns die Möglichkeit, unsere Ziele zu durchdenken, zu diskutieren, zu verfeinern und mit Teams und Stakeholdern zu kommunizieren, um ein besseres Endprodukt zu schaffen.
• Während wir uns auf die Bedürfnisse unserer Kunden konzentrieren, verstehen wir, wie wir APIs am besten entwerfen, die diese Bedürfnisse erfüllen.

Diese Denkweise stellt unsere APIs und Kunden an erste Stelle und ist entscheidend, um eine Grundlage zu schaffen, in der bei Zonos alle für den Kundenerfolg verantwortlich sind.

Entwicklungsteams können parallel arbeiten

Der API-first-Ansatz beinhaltet die Festlegung eines Vertrags. Ein Vertrag zwischen Services, der von Teams in der gesamten Organisation eingehalten wird, ermöglicht es diesen Teams, gleichzeitig an mehreren APIs zu arbeiten. Entwickler müssen nicht warten, bis API-Updates veröffentlicht werden, bevor sie zur nächsten API übergehen. Teams können APIs und API-Abhängigkeiten gleichzeitig mocken und testen, basierend auf vorab definierten API-Definitionen.

Senkt die Entwicklungskosten

APIs und Code können in vielen verschiedenen Projekten wiederverwendet werden. Beim API-first-Ansatz muss ein Entwicklungsteam, das eine neue Anwendung bauen möchte, nicht bei null anfangen – das spart Zeit und Geld. API-first-Design ermöglicht zudem, die meisten Probleme zu lösen, bevor überhaupt Code geschrieben wird, was Probleme bei der Integration von APIs in Anwendungen verhindert.

Erhöht die Time-to-Market

Ein Großteil des API-Entwicklungsprozesses kann mit Tools automatisiert werden, die API-Definitionsdateien importieren. Wir beginnen mit der Generierung der Kerntypen, Definitionen und Schemas; mit diesen Dateien können API-Tools wie API-Dokumentation, Software Development Kits (SDKs) und Mock-APIs automatisch generiert werden. Automatisierung beschleunigt die Entwicklung von APIs und Anwendungen erheblich.

API-first macht es zudem möglich, neue Services und Technologien zu Anwendungen hinzuzufügen, ohne das gesamte System neu zu architektieren. Zonos muss Features schnell in Produktion bringen, um im sich ständig wandelnden Cross-Border-SaaS-Markt wettbewerbsfähig zu bleiben. Es ist einfacher, technische Schulden im zugrunde liegenden Code abzubauen, als Kunden von einer schlecht designten API wegzumigrieren.

Sichert gute Developer Experiences

API-Konsumenten sind meist Entwickler, und Developer Experience (DX) kann den Erfolg einer API entscheiden. Der API-first-Ansatz stellt sicher, dass die Developer Experience positiv ist, weil eine gut designte, gut dokumentierte, konsistente API einfacher zu erlernen und wiederzuverwenden ist. Das erhöht zudem die Implementierungsgeschwindigkeit. Diese Vorteile hängen alle miteinander zusammen!

Erhöht langfristigen Erfolg

Ein API-first-Ansatz ermöglicht schnelles Prototyping und Iteration – wir lernen schneller, was funktioniert und was nicht. Wie Edisons 1.000 gescheiterte Versuche vor der Glühbirne bedeutet API-first, dass wir schnell scheitern und mit besserem Verständnis voranschreiten, wie Erfolg erreicht wird. API-first steigert unseren langfristigen Erfolg, indem es sicherstellt, dass APIs zuverlässig, konsistent und für Entwickler einfach nutzbar sind.

Warum ist rückwärts arbeiten effektiv? 

2015 hatte ich die Gelegenheit, die E-Commerce-Site einer bekannten Consumer-Marke neu zu gestalten. Ich evaluierte verschiedene KPIs des bestehenden Systems, und es war klar, wo die größten Verbesserungen möglich waren:

• Die Desktop-Conversion-Rate war unterdurchschnittlich.
• Die Mobile-Conversion-Rate war miserabel.
• Der Anteil des mobilen Traffics stieg schnell und würde innerhalb der nächsten 12 Monate 50 % des Gesamttraffics überschreiten. Wegen der miserablen Mobile-Conversion-Rate war der hohe Mobile-Anteil nicht ideal.

Angesichts der Daten: Was würde den größten Wert für Nutzer schaffen? Es war offensichtlich: die Probleme mit der mobilen User Experience der Site beheben. Deshalb verfolgte ich einen Mobile-first-Ansatz beim Redesign. Das bedeutete, dass alle Designs, Architekturen, APIs usw. zuerst die mobile Erfahrung berücksichtigten. Das war rückwärts zum damaligen traditionellen Ansatz, der zuerst auf Desktop fokussierte und die mobile Erfahrung oft als nachträglich angeflanschte Afterthought mit schlechten Conversion-Rates hinterließ. Der Mobile-first-Ansatz erforderte zudem mehr Aufwand im Vorfeld – es war nicht der einfache Weg. Eine neue Architektur war nötig, neue APIs mussten geschrieben werden, und für jeden Breakpoint waren mehrere Designs erforderlich.

Der Mobile-first-Ansatz führte zu einem deutlichen Anstieg der Mobile-Conversion-Rate. Die neue Architektur brachte zudem beeindruckende Gewinne bei der Desktop-Conversion-Rate. Der Ansatz war erfolgreich, weil er identifizierte, wie maximaler Nutzerwert geschaffen wird, und den gesamten Ansatz darauf ausrichtete. Er schuf von Anfang an die richtige Denkweise. Ebenso – auch wenn es sich rückwärts anfühlen mag – schafft ein API-first-Ansatz Möglichkeiten, übergreifende Probleme zu identifizieren und dann eine Grundlage zu bauen, um diese zu beheben.

Was ist die Verantwortung der Entwicklung? 

Die API-first-Denkweise hat Zonos zum Erfolg geführt und wird das auch weiter tun – die Entwicklung spielt dabei eine zentrale Rolle. Es ist unsere Verantwortung, die API-first-Denkweise stets aufrechtzuerhalten. Das bedeutet, dass wir ständig Fragen stellen, die den Fokus auf unsere APIs halten, wie: „Wie können unsere APIs die Bedürfnisse des Kunden erfüllen“ Es bedeutet zudem, dass wir auf Fragen zu Features und Funktionalität immer mit einem Link zu unserer API-Dokumentation antworten. Wenn die Dokumentation nicht existiert, erstellen wir sie – in cross-funktionalen Teams zusammenarbeitend, um sicherzustellen, dass Zonos hervorragende API-Dokumentation hat.