At systemet har åpne, dokumenterte grensesnitt — slik at dere kan koble det til noe annet senere.
Hvorfor det er viktig
Et system uten API er en øy. Før eller siden skal data ut eller inn, og da avgjør grensesnittet om det er en konfigurasjonsjobb eller et prosjekt. Dette er også et av de sterkeste vernene mot innlåsing.
Eksempel på kravformulering
Systemet skal eksponere all forretningskritisk funksjonalitet gjennom et dokumentert API basert på åpne standarder, med maskinlesbar spesifikasjon (OpenAPI). API-et skal versjoneres, og bakoverkompatibilitet skal opprettholdes i minimum 12 måneder etter varsel om endring. Oppdragsgiver skal ha full tilgang til API-et uten særskilt vederlag.
Tilpass tallene til deres virkelighet — et krav du ikke kan begrunne, er et krav du ikke bør stille.
Slik verifiserer du det
Be om OpenAPI-spesifikasjonen. Finnes den ikke, er API-et enten udokumentert eller ikke-eksisterende. Sjekk også at API-et dekker det grensesnittet gjør — ikke bare en brøkdel.
Fallgruver
API-tilgang som koster ekstra, eller som er begrenset til leverandørens egne partnere. Da eier dere dataene i teorien, men får dem ikke ut i praksis.
AI-perspektiv
Et veldokumentert API med OpenAPI-spesifikasjon er også det som gjør systemet tilgjengelig for AI-agenter senere. Åpne, maskinlesbare grensesnitt er fremtidssikring.