Hvad betyder API?
API står for application programming interface. Det er en kontrakt mellem softwarekomponenter. Kontrakten beskriver, hvilke funktioner der kan kaldes, hvilke oplysninger der kræves, og hvilke resultater eller fejl der kan returneres. API'er findes både inde i programmer og som netværkstjenester.
For en virksomhed er et API ofte forbindelsen mellem webshop, CRM, økonomisystem og interne værktøjer. For en AI-agent kan API'et ligge bag et afgrænset værktøj. Modellen kan foreslå et kald, men det er den udførende software, der skal kontrollere adgang og håndtere resultatet.
Forstå mere end endpointets navn
En brugbar integration kræver viden om inputfelter, datatyper, objekt-ID'er, adgang, begrænsninger og fejl. Det er ikke nok, at et system har “et API”. Den nødvendige handling kan mangle, eller en eksisterende funktion kan kræve oplysninger, som processen ikke har.
En maskinlæsbar beskrivelse som OpenAPI kan gøre HTTP-API'er lettere at forstå og validere. Den erstatter dog ikke forretningsregler og test. To felter med navnet “status” kan betyde forskellige ting i to systemer. Datamappingen skal derfor beskrive den faktiske betydning, ikke blot matche ens feltnavne.
En integration skal tåle fejl og ændringer
Planlæg for tidsudløb, begrænset kaldfrekvens og ændrede versioner. Når et kald ikke giver et svar, kan handlingen alligevel være gennemført. Et sikkert genforsøg kræver derfor kontrol af virkningen og eventuel idempotens. Log korrelations-ID'er og relevante fejl uden at udskrive hemmeligheder. Aftal også, hvilket system der er autoritativt for hver oplysning. Uden denne regel kan to integrationer overskrive hinandens ændringer og skabe en løbende synkroniseringskonflikt.
Et eksempel fra praksis
Et bureau forbinder en henvendelsesformular til CRM. API-kontrakten kræver kontaktoplysninger og en kilde, men skelner mellem en kontakt og en salgsmulighed. Integrationen opretter derfor ikke automatisk begge dele ved hvert formulartryk. Den undersøger dubletter, gemmer det returnerede ID og registrerer fejl til opfølgning. En test sender samme henvendelse to gange og kontrollerer, at systemet følger den aftalte dubletregel.
Typiske faldgruber
- At antage, at et tilgængeligt API dækker enhver ønsket handling.
- At mappe felter efter navn uden at kontrollere betydningen.
- At genforsøge ændringer blindt efter et tidsudløb.
Det skal I afklare
- Bekræft nødvendige handlinger og deres konkrete kontrakter.
- Afklar adgang, versionsstyring og ejerskab til hver datatype.
- Test fejl, dubletter og delvist gennemførte forløb.
Spørgsmål og svar
Er et API det samme som en webhook?
Nej. Et API beskriver en grænseflade til kald. En webhook er typisk en måde at levere en hændelse til en modtagers endpoint. De bruges ofte sammen.
Kan AI arbejde med et API uden kode?
Et værktøj eller en platform kan skjule meget af koden, men der er stadig en teknisk integration. Rettigheder, datafelter og fejl skal forstås og kontrolleres, uanset hvordan den er bygget.
Kilder og videre læsning
De tekniske begreber bygger på nedenstående kilder. Eksemplerne er illustrative og viser, hvordan I kan arbejde med emnet.
- OpenAPI Specification ↗Maskinlæsbare kontrakter for HTTP-API'er.
- Microsoft: Web API design ↗Ressourcer, metodevalg og kontrakter i web-API'er.