API-guide til AI og automation

API’et er kontrakten mellem dine systemer

Et API bliver lettere at arbejde med, når du tænker i kontrakter: endpoint, metode, autentifikation, input, output, statuskoder og rate limits. AI kan hjælpe med kode og forklaring, men den kan ikke erstatte den aktuelle dokumentation.

Case: læs, valider og skriv med tydelige skemaer

Design auth, request og response før AI kobles på

1. 1. Læs dokumentationen for autentifikation og de konkrete endpoints du skal bruge.
2. 2. Test request manuelt med et sikkert udviklingsmiljø.
3. 3. Definér hvilke statuskoder der skal stoppe, genforsøg eller håndteres.
4. 4. Valider response-skema før næste trin.
5. 5. Respekter rate limits og brug backoff.
6. 6. Log request-id og relevante metadata uden at lække secrets.

Rate limits og partial failure skal være forventede

• At lade LLM’en “gætte” et API endpoint.
• At genforsøg 4xx-fejl ukritisk.
• At lægge API keys direkte i prompt eller kode der commits.

Kald ét API med kontrolleret fejlvej

Tag et offentligt test-API. Dokumentér en GET og POST med autentifikation, forventede statuskoder og fejlplan, før du automatiserer det.

Test 401, 429, timeout og ugyldig JSON

• Kan du forklare autentifikationflowet?
• Er fejltyper adskilt?
• Er secrets ude af logfiler/prompts?

Læs API-kontrakten før du designer prompten

Find endpoint, auth-metode, required fields, rate limits, pagination og fejlformater. Lav ét manuelt request med kendte data og gem det forventede response. Først derefter bør AI generere eller fortolke noget omkring kaldet.

Når et værktøj eller workflow skriver via API, bør argumenterne valideres mod et skema. Et HTTP 200 betyder heller ikke nødvendigvis, at forretningshandlingen er korrekt; nogle API’er returnerer delvise resultater eller asynkrone jobs, der skal følges op.

Test 401/403, 404, 429, timeout og ugyldigt input. De cases fortæller dig, hvordan genforsøg og reservevej faktisk skal se ud.

Fortsæt med webhooks, MCP og agent-værktøjer

• Webhooks forklaret: sådan forbinder du workflows
• MCP guide: servere, clients og værktøjer
• Tool calling

Et komplet request består af mere end URL’en

Notér metode, endpoint, headers, auth, query/body, forventet response og timeout. Gem et eksempel på et kendt godt request og response. Det bliver din reference, når et senere AI-genereret kald eller workflow ikke virker.

Pagination og asynkrone jobs er klassiske produktionsfælder

Et API kan returnere første side korrekt uden at du opdager, at resten mangler. Andre endpoints svarer “job oprettet” og kræver polling eller webhook før resultatet findes. Læs derfor hele responskontrakten – ikke kun status 200.

Byg en fejlmatrix før du automatiserer

Definér hvad der sker ved auth-fejl, valideringsfejl, rate limit, timeout og leverandørens 5xx. Skriv hvilke fejl der genforsøges, hvor mange gange, og hvilke der kræver menneske eller ny input. Det forhindrer det klassiske “genforsøg alt”-workflow.

AI-genereret integrationskode skal behandles som et udkast

Sammenlign endpoints og felter med den aktuelle officielle dokumentation, hold secrets i adgangsoplysning storage, og kør tests i et miljø hvor fejl ikke påvirker rigtige kunder. Modellen kan accelerere arbejdet, men kontrakten ejes af API-udbyderen.