rajapintakuvaukset
Rajapintakuvaukset ovat järjestelmän rajapinnoille koostettuja dokumentteja, joiden tarkoituksena on määritellä, miten eri ohjelmiston osat tai laitteet voivat kommunikoida keskenään. Ne voivat käsittää ohjelmistojen ohjelmointi-rajapinnat (API), moduulien väliset rajapinnat sekä laitteiden ohjausrajapinnat. Tavoitteena on selkeä ja kiistaton yhteistoimintasopimus, jonka perusteella toiminta on ennustettavaa ja jonka avulla kehitys, testaus ja ylläpito voidaan hallita johdonmukaisesti.
Rajapintakuvaukset kattavat yleensä: päätepisteet tai toiminnot, viestien rakenteet (pyynnöt ja vastaukset), käytetyt tiedostomuodot ja tiedot, autentikointi
Suositumpia malleja ovat OpenAPI (Swagger), RAML ja API Blueprint REST-rajapinnoille sekä WSDL SOAP:lle; AsyncAPI taas asynkronisille
Hyödyllisiä käytäntöjä ovat riippuvuuksien hallinta, versionointi, sekä contract testing -testaus, joka varmistaa, että osapuolet noudattavat sovittua