Peter Van den Bosch
Peter Van den Bosch
#### Bug Report Checklist - [X] Have you provided a full/minimal spec to reproduce the issue? - [X] Have you validated the input using an OpenAPI validator ([example](https://apidevtools.org/swagger-parser/online/))? - [X]...
We're regularly encountering errors when oneOf or discriminators are being used. * OpenAPI document authors sometimes mistakenly assume that the oneOf subschema types are part of the JSON message; and...
OpenAPI allows enum values that are invalid to the rest of a schema, e.g. integer enum values for string types. In OpenAPI such contradiction is allowed; the most restrictive constraint...
Add a guideline that operationId MUST be present for each operation: * This operationId is used by code generation tools; using it will avoid warnings and bad method names: `Empty...
In builds of rest-guide and the openapi-* projects, we have some deprecation warnings in the builds about * https://github.blog/changelog/2023-09-22-github-actions-transitioning-from-node-16-to-node-20/ => will be problem in Spring 2024 * https://github.blog/changelog/2022-10-11-github-actions-deprecating-save-state-and-set-output-commands/ For rest-guide,...
I often find that the names of properties used in the "required" array haven't been kept in sync with their defined names. For example: ```YAML type: object properties: nameNew: type:...
Open source the styleguide validation tool developed at Smals, in new repo under belgif. Would be published as Apache License 2.0.
REST API designers sometimes struggle to represent resources that are defined by a composite business key with a proper URI. E.g. in case of a monthly declaration of a an...
Current rule: https://www.belgif.be/specification/rest/api-guide/#rule-oas-descr > The title property MUST NOT be used because it hides the actual data type name in visualization tools like Swagger UI. However, title property is useful...