Hur en API-first-strategi formar framtiden för Zonos

Vad är en API-first-strategi? 

API-first-strategin skiljer sig markant från kod-first-strategin, där ett team börjar med att designa applikationens funktionalitet, skriva koden och därefter lägga till API:er i slutet av processen.

På Zonos innebär det att bygga programvara med en API-first-strategi att man designar lösningar utifrån ett API, snarare än att koda en applikation och lägga till ett API senare. Det innebär att våra API:er är av yttersta vikt och produkter i sin egen rätt; vi utformar dem med ett intensivt fokus på kundens behov, och vi dokumenterar och arkitekturerar dem tydligt innan vi skriver någon kod.

Fördelarna med en API-first-strategi 

API-first-strategin bidrar till att skapa följande synsätt:

• Vi förstår att våra API:er är det primära gränssnittet för våra kunder och betraktar dem därför som våra offentliga leveranser.
• Att dokumentera innan vi skriver kod ger oss möjlighet att resonera, diskutera, förfina och kommunicera våra mål med våra team och intressenter för att skapa en bättre slutprodukt.
• Genom att fokusera på våra kunders behov förstår vi bäst hur vi ska designa API:er som uppfyller dessa behov.

Detta synsätt sätter våra API:er och kunder i första rummet och är avgörande för att skapa en grund där alla på Zonos ansvarar för kundframgång.

Utvecklingsteam kan arbeta parallellt

API-first-strategin innebär att man etablerar ett kontrakt. Att skapa ett kontrakt mellan tjänster som följs av team i hela organisationen gör att dessa team kan arbeta med flera API:er samtidigt. Utvecklare behöver inte vänta på att API-uppdateringar släpps innan de går vidare till nästa API. Team kan samtidigt mocktesta API:er och API-beroenden baserat på fördefinierade API-definitioner.

Minskar utvecklingskostnaderna

API:er och kod kan återanvändas i många olika projekt. Med en API-first-strategi behöver ett utvecklingsteam som vill bygga en ny applikation inte börja om från noll, vilket sparar tid och pengar. API-first-design gör det också möjligt att lösa de flesta problem innan någon kod alls skrivs, vilket bidrar till att förhindra problem när det är tid att integrera API:er med applikationer.

Ökar hastigheten till marknaden

Mycket av processen för att bygga API:er kan automatiseras med verktyg som importerar API-definitionsfiler. Vi börjar med att generera kärntyper, definitioner och scheman; med dessa filer kan API-verktyg som API-dokumentation, mjukvaruutvecklingskit (SDK:er) och mock-API:er skapas automatiskt. Automatisering snabbar avsevärt upp utvecklingen av API:er och applikationer.

API-first gör det också möjligt att lägga till nya tjänster och teknologier i applikationer utan att behöva omarkitektera hela systemet. Zonos måste leverera funktioner till produktion snabbt för att förbli konkurrenskraftigt på den ständigt föränderliga SaaS-marknaden för gränsöverskridande handel. Det är lättare att eliminera teknisk skuld i den underliggande koden än att migrera kunder bort från ett dåligt utformat API.

Säkerställer goda utvecklarupplevelser

API-konsumenter är oftast utvecklare, och utvecklarupplevelsen (DX) kan avgöra om ett API blir en framgång. API-first-strategin säkerställer en positiv utvecklarupplevelse eftersom ett väldesignat, väldokumenterat och konsekvent API är lättare att lära sig och återanvända. Detta ökar också implementeringshastigheten. Dessa fördelar hänger alla samman!

Ökar den långsiktiga framgången

En API-first-strategi möjliggör snabb prototypframtagning och iteration, vilket innebär att vi snabbare lär oss vad som fungerar och vad som inte gör det. Precis som Edisons 1 000 misslyckade försök innan han skapade glödlampan, innebär API-first att vi misslyckas snabbt och går vidare med bättre förståelse för hur vi uppnår framgång. API-first ökar vår långsiktiga framgång genom att säkerställa att API:er är tillförlitliga, konsekventa och lätta för utvecklare att använda.

Varför är det effektivt att arbeta baklänges? 

År 2015 hade jag möjlighet att omdesigna e-handelssajten för ett populärt konsumentvarumärke. Jag utvärderade olika nyckeltal (KPI:er) relaterade till det befintliga systemet, och det var tydligt var de största förbättringarna kunde göras:

• Konverteringsgraden på desktop var under standard.
• Konverteringsgraden på mobil var usel.
• Andelen mobiltrafik ökade snabbt och skulle överstiga 50 % av den totala trafiken inom de kommande 12 månaderna. På grund av den usla mobila konverteringsgraden var det inte optimalt att så mycket av trafiken var mobil.

Givet dessa data, vad skulle skapa mest värde för användarna? Det var uppenbart: att åtgärda problemen med sajtens mobila användarupplevelse. Därför tog jag ett mobile-first-synsätt vid omdesignen av sajten. Detta innebar att all design, arkitektur, API:er osv. först tog hänsyn till mobilupplevelsen. Detta var baklänges jämfört med det traditionella tillvägagångssättet på den tiden, som först fokuserade på skrivbordsupplevelsen och ofta lämnade mobilupplevelsen som en klumpigt tillagd eftertanke med dåliga konverteringsgrader. Mobile-first-strategin krävde också mer arbete i förväg – det var inte den enkla vägen. En ny arkitektur behövdes, nya API:er behövde skrivas, och flera designer krävdes för varje brytpunkt.

Mobile-first-strategin resulterade i en betydande ökning av den mobila konverteringsgraden. Den nya arkitekturen gav också imponerande förbättringar av konverteringsgraden på desktop. Strategin lyckades eftersom den identifierade hur man skapar maximalt användarvärde och inriktade hela strategin på att leverera det värdet. Den skapade rätt synsätt från början. På samma sätt – även om det kan kännas som att arbeta baklänges – skapar en API-first-strategi möjligheter att identifiera övergripande problem och därefter bygga en grund för att åtgärda dem.

Vad är ingenjörernas ansvar? 

API-first-synsättet har och kommer att fortsätta leda Zonos till framgång, och ingenjörerna spelar en central roll. Det är vårt ansvar att alltid upprätthålla API-first-synsättet. Detta innebär att vi ständigt ställer frågor som håller fokus på våra API:er, till exempel: ”Hur kan våra API:er tillgodose kundens behov?” Det innebär också att vi alltid besvarar frågor om funktioner och funktionalitet med en länk till vår API-dokumentation. Om dokumentationen inte finns skapar vi den – genom att arbeta tillsammans i tvärfunktionella team för att säkerställa att Zonos har förträfflig API-dokumentation.