Når en webshop sender en ordre til et økonomisystem, eller et bookingsystem viser ledige tider fra en kalender, sker det ofte gennem en API-integration. En API er en aftalt måde, hvorpå to softwaresystemer kan bede hinanden om data eller handlinger.
For virksomheden betyder integrationen mindre manuel indtastning, hurtigere processer og færre kopifejl. Men en forbindelse mellem systemer skal designes og overvåges. Ellers flytter den blot fejl automatisk fra ét sted til et andet.
Hvad betyder API?
API står for Application Programming Interface. Det er et sæt regler og adresser, som et system stiller til rådighed. Et andet system kan for eksempel bede om en kundes ordrestatus eller sende en ny faktura.
APIet definerer hvilke oplysninger der kan udveksles, hvilket format de har, og hvordan adgang kontrolleres. Det er ikke en åben bagdør til hele systemet. En god integration får kun de rettigheder, den har brug for.
Et enkelt eksempel
En kunde udfylder en formular på hjemmesiden. Integrationen sender navn, kontaktoplysninger og interesse til CRM-systemet. CRM opretter et lead og returnerer et id. Hjemmesiden gemmer idet, så senere aktiviteter kan knyttes til den rigtige kunde.
Hvis CRM ikke svarer, skal formularen stadig kunne fortælle kunden, at henvendelsen er modtaget, eller tydeligt forklare næste skridt. Data må ikke bare forsvinde.
API, filoverførsel eller manuel proces?
En API er god til løbende udveksling og hurtige svar. En planlagt filoverførsel kan være enklere til store mængder data én gang om dagen. Manuel behandling kan være det rigtige valg ved få sager eller høj risiko.
Vælg efter behov, ikke efter hvad der lyder mest moderne. En stabil CSV-fil kan være bedre end en skrøbelig realtidsintegration, hvis virksomheden kun har brug for en daglig opdatering.
Hvad skal afklares før udvikling?
- Hvilket system ejer de enkelte data?
- Hvilke felter skal udveksles, og hvor ofte?
- Hvad sker der ved manglende eller ugyldige værdier?
- Hvilke handlinger må integrationen udføre?
- Hvordan opdages og håndteres fejl?
- Hvem har ansvar for drift og ændringer?
Tegn gerne processen fra start til slut. Det afslører dobbeltregistrering, uklare ejere og undtagelser, før der skrives kode.
Adgang og sikkerhed
APIer bruger typisk nøgler, tokens eller en loginstandard som OAuth. Hemmeligheder skal opbevares sikkert og aldrig ligge direkte i offentlig kode. Brug mindst mulige rettigheder, og roter adgangsoplysninger efter en fast politik.
Kontrollér også afsenderen ved indgående beskeder som webhooks. Ellers kan uvedkommende forsøge at sende falske ordrer eller statusændringer.
Fejlhåndtering er en del af produktet
Netværk og tjenester fejler. En robust integration har timeout, genforsøg og en kø til opgaver, der ikke kan gennemføres med det samme. Genforsøg skal designes, så den samme ordre ikke oprettes flere gange.
Brug en unik nøgle til hver handling. Hvis systemet modtager den samme besked igen, skal det kunne genkende den og returnere det eksisterende resultat.
Overvågning og logning
Det er ikke nok at logge, at noget gik galt. Loggen skal vise hvilket trin, hvilken sag og hvilken fejltype der var involveret uden at gemme unødige personoplysninger. Opsæt alarmer for stigende fejlrate, langsomme svar og fyldte køer.
Lav et overskueligt dashboard med antal vellykkede og fejlede handlinger. Driftsteamet skal kunne genkøre en sag sikkert eller sende den videre til en ansvarlig medarbejder.
Versioner og ændringer
Leverandører ændrer APIer. Felter kan blive udfaset, grænser kan ændres, og nye godkendelseskrav kan komme til. Registrer hvilke versioner I bruger, og følg leverandørens ændringslog.
Test opdateringer i et stagingmiljø med realistiske, men sikre testdata. Hav en rollbackplan, hvis den nye version giver problemer.
Personoplysninger og databehandlere
Kortlæg hvilke personoplysninger der bevæger sig mellem systemerne. Send kun det nødvendige, og aftal opbevaring og sletning. Hvis en ekstern tjeneste behandler data, skal rolle og databehandleraftale være afklaret.
En integration kan gøre sletning mere kompleks, fordi den samme person findes flere steder. Design derfor en proces, der kan finde og håndtere data på tværs af systemer.
Hvad koster en integration?
Prisen afhænger af dokumentation, datakvalitet, antal flows, sikkerhed og driftskrav. En enkelt envejsforbindelse er billigere end tovejssynkronisering med konflikthåndtering. Medregn overvågning, support og ændringer hos leverandørerne.
En pilot kan afklare de største usikkerheder. Test én vigtig arbejdsgang, før alle data og scenarier kobles sammen.
APIer og AI-agenter
En AI-agent bruger ofte APIer som værktøjer. Den kan finde en ordre, oprette en opgave eller klargøre et tilbud. Agenten bør ikke få bredere rettigheder end nødvendigt, og kritiske handlinger skal kræve godkendelse.
Læs guiden til AI-agenter og automatisering af arbejdsgange. Se også softwareudvikling med AI. I kan beskrive en integrationsopgave i EesyPlus AI Problem Lab.
