/core/semver

Deze regel schrijft voor dat versionering van API's via Semantic Versioning (major.minor.patch formaat) moet geschieden.

• Regel: https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0.2/#/core/semver

Uitdrukken in OAS

YAML

/openapi.yaml

openapi: 3.0.0
info:
  title: API van developer.overheid.nl
  version: 1.0.0 # goed
  version: 1 # fout, minor en patch versie ontbreken

JSON

/openapi.json

{
  "openapi": "3.0.0",
  "info": {
    "contact": {
      "name": "Dimitri",
      "email": "dimitri@geonovum.nl",
      "url": "https://www.google.com"
    }
  }
}