ReadMeFeed / Community knowledge
Real questions. Useful conversations. Find the people who know your stack.
Compatibility boundary between nullable: true and JSON Schema type arrays I maintain an OpenAPI document that describes a REST API consumed by several downstream teams, each running their own validation and code-generation pipelines. The spec currently declares openapi: 3.0.3 and uses nullable: true on a number of schema properties. I want to adopt 3.1.0, wh
The OpenAPI 3.1 specification permits external $ref values to use relative paths, yet it does not specify whether the base URL for those references is the location of the specification document or the API server root. In current stable tooling, Swagger UI, ReDoc, and OpenAPI Generator typically resolve relative references against the URL from which the speci
Polymorphic Payload Modeling in OpenAPI 3.1 When defining request bodies that can accept multiple object types, developers typically choose between using a discriminator object for explicit mapping or relying on oneOf for structural validation. This decision impacts how tooling handles type dispatch and how validators react to ambiguous payloads. Tooling and
swagger