Henri Korver

[Subscription API] Purpose of Filter schema object in OAS not clear

9

In the OAS for the Subscription API the Filter object is included: ```yaml Filter: title: "Filter" description: "A filter from a selection of multiple filter types and dialects" type: object...

[Subscription API] I get confused by introduction section about filter dialects

10

Section [3.2.4.1 Filter Dialects](https://github.com/cloudevents/spec/blob/main/subscriptions/spec.md#3241-filter-dialects) tells that Filter dialects are identified by a unique URI-Reference. ``` { "dialect URI-Reference" : { } } ``` However, in the first filter dialect that...

[Subscription API] OAS schema for filter expressions seems not to be correct

9

Trying the understand the CE filter expressions, I have converted the [OAS schema for the Subscription API](https://github.com/cloudevents/spec/blob/main/subscriptions/subscriptions-openapi.yaml) to JSON Schema (see at the bottom of this message). This allows me...

Gegenereerde OAS mag niet publiekelijk zichtbaar zijn

1

# Bug Via de veelgebruikte openbare link https://zaken-api.vng.cloud is de genereerde versie van de OAS van de Zaken API te zien (klik [hier](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/vng-Realisatie/zaken-api/1.5.1/src/openapi.yaml)). Deze OAS is gegenereerd vanuit de code...

# Scrumtaak Als het goed is, is wordt het expand probleem nu structureel opgelost met PR #2377. Nu geeft de Zaken API OAS precies aan welke expands precies ondersteund worden,...

Oplossen fout in OAS m.b.t. expand

2

N.a.v. issues #2412 en #2414. In de resources `rollen` en `zaakobjecten` komt het attribuut `_expand` (onterecht) voor. Dit is verwarrend want dit attribuut kan alleen indirect gebruikt worden via de...

Als API Designer wil ik dat er in de OAS-schema's geen componenten worden gedupliceerd

8

zodat: * objectdefinities niet uit elkaar gaan lopen, * het standaardisatieproces beter kan worden gefaciliteerd als API's hergebruik maken van dezelfde OAS-libraries, * de verschillen beter te zien zijn bij...

OAS-specificatie voor het opvragen van STATUSsen is niet duidelijk

7

Het is niet duidelijk dat je in de query-parameter `zaak` *meerdere* url's mag meegeven (zie screen shot onderaan), hoewel dit cruciaal is als je op efficiente wijze de statusdetails van...

zodat ik niet te lang hoef te zoeken. In de huidige opzet zie je alleen het nummer van de sprint maar je niet het thema waarover de sprint gaat: https://github.com/VNG-Realisatie/gemma-zaken/tree/023a4ca1b3a21a07820e893d1abe6108b271bcd4/docs/_content/community/bestanden

Ten eerste zou je verwachten dat je een foutmelding of op zijn minst een waarschuwing krijgt als je in een PUT operatie niet alle elementen hebt meegegeven die in het...