Peter Van den Bosch

suffix: Expected instead of Required is preferred | zeroOrOneOfExpected | moreThanOne/tooMany/mutuallyExclusive | | anyOfExpected | missingOneOf | | exactlyOneOfExpected | missingOneOf or moreThanOne/tooMany/mutuallyExclusive (dependent on input) | | zeroOrAllOfExpected |...

we can also document 428 - Precondition required https://httpstatus.in/428/ if If-Match header is missing, but this may be more difficult to implement : if OpenAPI document mandates the header, it's...

I guess "explode: true" shouldn't be used with spaceDelimited and pipeDelimited. "OpenAPI spec":https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#style-examples doesn't specify this, only the swagger doc but doesn't make much sense. The default query parameter serialization...

My proposition... For query params: * use defaults (style: form, exploded: true). * This is compatible with our current guidelines for primitive values and arrays/multi-valued. * perhaps recommend against using...

tested a bit with openapi-generator for spring-boot and jax-rs, but couldn't get code generation to work properly for object query parameters ```YAML /getSomething: get: operationId: getSomething parameters: - in: query...

A feature of OpenAPI I hadn't noticed yet before: it also supports specifying a parameter using a media type: * https://swagger.io/docs/specification/describing-parameters/ * https://spec.openapis.org/oas/v3.1.0#parameter-object ```YAML parameters: - in: query name: select...

Rule on OpenAPI data types is already present: Rule: Common definitions for Belgian government institutions [[oas-comdef]](https://www.belgif.be/specification/rest/api-guide/#rule-oas-comdef) Rule on FedVoc TODO, may with some guidance on how to map these to...

The current InputValidationIssue defines a simple structure for the most common use case; but its fields aren't mandatory and additional properties are allowed so you can still choose an entirely...

discussed on WG, but no conclusion yet. How frequent do this type of input validation issues occur? * can we list examples of APIs that mandate a group of query...

With openapi-generator oneOf can generate some weird model classes; it doesn't even work for jax-rs currently https://github.com/OpenAPITools/openapi-generator/issues/5565 , so maybe avoid it... Other possibilities: * change InputValidationIssue to support multiple...