Vad är en API-integration?

En API-integration gör att program kan utbyta information: en beställning från webbutiken förs över till ekonomisystemet, ett lagersaldo hämtas eller en formulärförfrågan hamnar i CRM-systemet.

API:et beskriver hur ett system kan kommunicera med ett annat. Integrationen avgör vilka uppgifter som skickas, när det sker och hur kommunikationen används i verksamheten.

Från webbutik till orderhantering

Webbutiken har produkter, antal, kunduppgifter och leveranssätt. Ekonomisystemet kan behöva andra fältnamn, artikelnummer och regler för att skapa en order.

Kopplingen översätter och validerar uppgifterna, skickar dem till mottagaren och håller reda på om överföringen lyckades. Samma beställning får inte skapa två order om den skickas igen. Det är därför mer arbete än att bara ansluta till två API:er.

Vilket system bestämmer uppgifterna?

Om produkter redigeras i både lager och webbutik behövs en regel för vilket system som styr pris, beskrivning och saldo. Olika fält kan ha olika källor.

Artikelnumret kan exempelvis identifiera samma produkt i båda systemen, medan pris och beskrivning hämtas från olika håll. Kopplingen måste veta vilka fält som flyttas, riktningen och hur mottagaren känner igen posten. Ändrade och borttagna produkter ingår också i flödet.

Överföringen kan starta vid en händelse eller köras schemalagt. Ett lagersaldo kan behöva vara färskare än en produktbeskrivning. Tillåten fördröjning, begränsningar i antal API-anrop och tillfälliga avbrott påverkar valet.

Vad händer när överföringen misslyckas?

Mottagaren kan vara otillgänglig, åtkomsten kan löpa ut eller uppgifterna kan underkännas. Felet ska gå att följa upp: vilken överföring misslyckades, vad var orsaken och vem hanterar den?

Loggning behövs utan att onödiga känsliga uppgifter hamnar i loggen. Omsändning måste vara säker och undvika dubbletter. Ett tillfälligt avbrott och felaktiga kunduppgifter kräver inte samma åtgärd; vissa fel behöver rättas av en människa.

Testa resultatet, inte bara svaret

För en order från e-handeln ska antal, artikelnummer, kund och leveranssätt stämma hos mottagaren. Ett positivt HTTP-svar betyder att systemet har svarat, inte nödvändigtvis att rätt order är registrerad.

Testa ett normalt fall och viktiga undantag. Upprepa samma överföring för att se att ingen dubblett skapas. Kontrollera även att en misslyckad överföring syns och går att hantera.

Finns rätt åtkomst och funktioner?

Att två system har ett API räcker inte. Det måste ge åtkomst till de uppgifter och funktioner som flödet kräver, med rätt behörigheter och eventuella tjänsteavtal. Dokumentation och en lämplig testmiljö visar vad som går att bygga.

Import- och exportfiler kan vara ett alternativ när API saknas. Även då behövs överenskomna format, tidpunkter och felhantering. En exportfil är inte ensam en fungerande integration.