Hva er et API?

Et API er et avtalt grensesnitt mellom systemer. Det beskriver hvilke data eller handlinger som er tilgjengelige, hvordan de kan brukes og hvilke svar man kan forvente.

Eksempler er betaling, regnskap, innlogging, kart, meldinger og kundedata.

Kartlegg dataflyten først

Før utvikling må det være tydelig hvilket system som eier informasjonen, når data skal flyttes og hva som skjer dersom noe feiler.

  • Hva er kilden til sannhet?
  • Skal data hentes i sanntid eller synkroniseres?
  • Hvem kan lese og endre informasjonen?
  • Hvordan oppdages og rettes feil?

Planlegg for endringer

Eksterne API-er kan endres, få nye begrensninger eller være utilgjengelige. Integrasjonen bør derfor ha god feilhåndtering, logging og en tydelig eier.

En direkte kobling som fungerer i dag er ikke nok dersom ingen vet hvordan den skal vedlikeholdes.

Sikkerhet og tilgang

Integrasjoner bruker ofte nøkler eller tokens. Disse skal lagres sikkert, gis minst mulig tilgang og kunne byttes uten å stoppe hele løsningen.

God integrasjonsutvikling handler like mye om ansvar og drift som om å sende data fra A til B.