Openbare-Consultaties

Consultatie API Design Rules versie 2.2

In het kader van het beheer en de doorontwikkeling van API Design Rules houdt Logius een openbare consultatie. Via deze consultatie nodigen wij u uit om feedback te geven op de standaard. De consultatie loopt tot 24 april 2026.

Bij het Technisch Overleg (TO) API (notulen) wordt gewerkt aan de nieuwe versie van API Design Rules, waarbij er drie nieuwe hoofdstukken zijn toegevoegd en enkele normatieve regels zijn gewijzigd.

Met deze openbare consultatie bieden wij belanghebbenden de gelegenheid om kennis te nemen van deze nieuwe versie en te reageren op de bijbehorende wijzigingen.

Reageren?

Feedback en suggesties zijn welkom via api@logius.nl of via issues op GitHub.
Help mee versie 2.2 klaar te maken ter vaststelling.

Wijzigingen

De volgende wijzigingen zijn onderdeel van de voorgestelde volgende release.

Consultatieversie 2026-03 (Diff met 2.1.0)

Wijzigingen:

• Nieuw hoofdstuk Naming conventions voor paden en query keys
• Nieuw hoofdstuk Date & Time
• Nieuw hoofdstuk Error Handling
• Signing en Encryption modules als normatief (wanneer relevant)
• RELEASING.md met informatie over versiewijzigingen
• Verduidelijking gebruik Nederlandse taal in /core/interface-language
• Voeg uitzondering op trailing slash toe voor root resource in /core/no-trailing-slash
• Maak semantiek van HTTP expliciet in /core/http-methods
• Verduidelijk gebruik van CORS header in combinatie met openapi.json in /core/transport/cors
• Verduidelijk hoe om te gaan met gevoelige informatie in URLs in /core/transport/no-sensitive-uris