Hvad er et API?

API er en af de forkortelser der dukker op i hvert tilbud og på hvert teknisk møde, ofte uden at nogen stopper op og forklarer den. For dig der træffer beslutningerne uden selv at skrive kode, er det alligevel værd at forstå hvad et API er, for det afgør mere om jeres digitale omkostninger og muligheder end de fleste er klar over. Den gode nyhed er at grundidéen er enkel.

Sammenligningen: bestillingen på restauranten

Forestil dig en restaurant. Du sidder ved bordet og vil have mad, men du går ikke ud i køkkenet og laver den selv. I stedet læser du menukortet, siger til tjeneren hvad du vil have, og efter et stykke tid kommer retten. Du behøver aldrig at vide hvordan køkkenet er organiseret, hvilke komfurer de har eller hvordan kokken arbejder. Du bestiller efter menukortet og får det du bad om.

Et API fungerer præcis sådan. Det er menukortet og tjeneren mellem to systemer. Det ene system læser hvad der kan bestilles, sender en forespørgsel og får et svar tilbage uden at skulle vide noget om hvordan det andet system fungerer indvendigt. Køkkenet er skjult; kun kontaktfladen er synlig. Den flade, med sine faste regler for hvad man kan bede om og hvad man får tilbage, er API’et.

Det tekniske navn er Application Programming Interface, men sammenligningen rækker længere end forkortelsen. Det vigtige er princippet: en aftalt, forudsigelig måde at bede et system om noget og få et svar.

Hverdagseksempler du allerede bruger

API’er er usynlige, men overalt. Nogle eksempler du med al sandsynlighed støder på dagligt:

• Vejret på din telefon. Vejrappen gemmer ikke selv vejrdata. Den spørger en vejrtjeneste via et API og viser svaret. Menukortet siger “giv mig prognosen for dette sted”, og tjenesten svarer.
• Kassen der taler med bogføringen. Når et salg slås ind i butikken, kan det automatisk bogføres i økonomisystemet. Det sker via et API mellem kassen og bogføringen. Ingen behøver at taste tallet ind to gange.
• Log ind med en eksisterende konto. Når en tjeneste lader dig logge ind med en konto du allerede har, sker kontrollen mod det andet system via et API.

Fælles for alle tre: to systemer der udveksler information uden at et menneske flytter den manuelt. Det er den hverdagsnytte API’er leverer, igen og igen.

Hvorfor gode API’er er et forretningsaktiv

Her bliver det et spørgsmål for dig som beslutningstager, ikke kun for udviklerne. Kvaliteten af et API afgør hvor let, og dermed hvor billigt, jeres systemer kan kobles sammen, bygges videre på og automatiseres.

Et godt API er veldokumenteret, stabilt og forudsigeligt. Det betyder at nye systemer kan kobles på hurtigt, at integrationer bliver billigere og at I kan bygge nye funktioner uden at opfinde den dybe tallerken hver gang. Det er et aktiv der bliver ved med at betale sig fordi hver fremtidig kobling drager nytte af at fundamentet er gennemtænkt.

Et dårligt API er det modsatte: svært at forstå, ustabilt eller dårligt beskrevet. Det ses ikke udadtil (funktionen kan se ens ud), men det gør hver integration dyrere, langsommere og mere risikabel. Det bliver en skjult omkostning der dukker op igen og igen, hver gang noget skal kobles på. Når I vurderer et system eller en leverandør, er API’ets kvalitet derfor en rimelig ting at spørge ind til selvom I ikke selv kan vurdere teknikken.

Hvor API’et slutter og integrationen begynder

En almindelig sammenblanding er API og integration. Forskellen er enkel: API’et er muligheden for at tale med et system, altså døren. En integration er når man faktisk bruger den mulighed til at koble to systemer sammen så de udveksler data, altså at gå igennem døren og bygge noget med det man finder. Et API kan eksistere uden at nogen bruger det; en integration er at sætte det i arbejde.

Vi hos Weapp bygger både API’er og de integrationer der bruger dem, og hjælper med at vurdere hvad et systems API betyder for jeres muligheder. Vil du forstå hvordan jeres systemer kan kobles sammen? Se vores ydelser eller kontakt os.