...
- Voor het beschrijven en specificeren van de Koppeltaal interfaces wordt geadviseerd om gebruik te maken van de OpenAPI Specification 3.0. Hierin worden interfaces eenduidig en leesbaar vastgelegd, zonder te hoeven weten hoe deze geïmplementeerd is. Zie Home - OpenAPI Initiative (openapis.org).
- Voeg Major wijzingen toe in de URI van een API (basis pad) met prefix 'v'. Minor- en Build nummers NIET toevoegen in de URI.
- Voeg de volledige Koppeltaal versie nummering toe in de response header. Voorbeeld: "API-Version: 1.0.2"
- Publiceer een wijzigingslog tussen twee versies.