Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Voorschrijven ontsluiten landingspagina zonder autorisatie #604

Open
PieterDijkstraKadaster opened this issue Jul 13, 2023 · 0 comments · May be fixed by Logius-standaarden/API-Design-Rules#165
Open

Voorschrijven ontsluiten landingspagina zonder autorisatie #604

PieterDijkstraKadaster opened this issue Jul 13, 2023 · 0 comments · May be fixed by Logius-standaarden/API-Design-Rules#165
Milestone
ADR v2.1.0

Comments

@PieterDijkstraKadaster
Copy link
Collaborator

Voor ontwikkelaars is het wenselijk dat voorgeschreven wordt dat er een landingspagina ontsloten wordt zonder autorisatie zodat duidelijk is waar informatie gevonden kan worden. Het ligt voor de hand dat dit de base url van een API is.
@fterpstra fterpstra added this to the ADR v2.1.0 milestone May 13, 2024
@TimvdLippe TimvdLippe mentioned this issue Feb 11, 2025
Open
TimvdLippe added a commit to Logius-standaarden/API-Design-Rules that referenced this issue Feb 11, 2025
@TimvdLippe
Definieer nieuwe regel voor publiceren van landing page
0e294e7 
Deze nieuwe regel zorgt ervoor dat consumers de API kunnen vinden en informatie
over de API kunnen lezen. Als deze root resource niet gedefinieerd is (en dus in
bijvoorbeeld een 404 resulteren), kunnen consumers onbewust concluderen dat de
API niet bestaat, terwijl dat wel het geval is.

Tevens lossen we hiermee de ambiguiteit met de OData specificatie op, die aangeeft
dat de service root URL in een slash moet eindigen (en dus beschikbaar moet zijn).
Voor OData APIs moet op deze root resource het OpenAPI specification document
gepubliceerd zijn.

Fixes Geonovum/KP-APIs#514
Fixes Geonovum/KP-APIs#530
Fixes Geonovum/KP-APIs#604
Fixes Geonovum/KP-APIs#624
@TimvdLippe TimvdLippe linked a pull request Feb 11, 2025 that will close this issue
Open
TimvdLippe added a commit to Logius-standaarden/API-Design-Rules that referenced this issue Mar 7, 2025
@TimvdLippe
Definieer nieuwe regel voor publiceren van landing page
79b5742 
Deze nieuwe regel zorgt ervoor dat consumers de API kunnen vinden en informatie
over de API kunnen lezen. Als deze root resource niet gedefinieerd is (en dus in
bijvoorbeeld een 404 resulteren), kunnen consumers onbewust concluderen dat de
API niet bestaat, terwijl dat wel het geval is.

Tevens lossen we hiermee de ambiguiteit met de OData specificatie op, die aangeeft
dat de service root URL in een slash moet eindigen (en dus beschikbaar moet zijn).
Voor OData APIs moet op deze root resource het OpenAPI specification document
gepubliceerd zijn.

Fixes Geonovum/KP-APIs#514
Fixes Geonovum/KP-APIs#530
Fixes Geonovum/KP-APIs#604
Fixes Geonovum/KP-APIs#624
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
ADR v2.1.0
Development

Successfully merging a pull request may close this issue.

Definieer nieuwe regel voor publiceren van landing page Logius-standaarden/API-Design-Rules
2 participants
@fterpstra @PieterDijkstraKadaster