Peter Van den Bosch
Peter Van den Bosch
Standardize common non-schemaViolation validation issues for belgif types. Currently CBSS has defined their own types: * urn:problem-type:cbss:input-validation:invalidSsin (when ssin is not found or has invalid checksum) * urn:problem-type:cbss:input-validation:replacedSsin (when ssin...
OpenAPI (JSON Schema) allows adding undefined additional properties in objects. For code generation, openapi-generator's default configuration will only deserialize unknown properties if `additionalProperties` is explicitly specified as `true` (i.e. generate...
When documenting the "GET /doc/openapi.yaml" operation in OpenAPI, as in [[doc-refdata]](https://www.belgif.be/specification/rest/api-guide/#rule-doc-refdata), max compatibility with tooling is achieved when specifying the payload as binary: ```YAML OpenApiResponse: description: OpenAPI document describing this...
Because the REST guide and the reusable OpenAPI documents mostly seem to be used for new APIs or major new revisions that use OpenAPI 3, we could consider phasing out...
In GitLab by @wsalembi on Feb 23, 2018, 8:07 Standardize on how to represent 'greater than', 'smaller than or equal than', etcetera in query parameters. Use cases are searches or...
In GitLab by @pvdbosch on Nov 14, 2019, 12:11 When creating or updating resources it may be necessary to expose conflicts and to prevent the 'lost update' or 'initially created'...
Publish the belgif OpenAPI schemas on https URLs, so they can be used without downloading and extracting a zip file. To publish them on the belgif.be site in both YAML...
Elaborate guidelines on media types: * multiple media types (with different schemas) in OpenAPI request/response: do we support it? See generator problems below. * list supported media types instead of...
From Smals guideline:  Can we adopt it? Similar: http://opensource.zalando.com/restful-api-guidelines/#216 Current guideline: https://www.belgif.be/specification/rest/api-guide/#rule-addi-prop > additionalProperties SHOULD be used exclusively to describe an object representing a map of key-value pairs....
In GitLab by @pvdbosch on Apr 25, 2018, 12:28 development of a REST mock API, serving as an example for the REST style guide Examples in the styleguide should be...