Skip to content

OpenAPI v3.1 Support #100

Description

@philsturgeon

Hello! As the maintainer of openapi.tools I'm interested in tracking progress towards supporting OpenAPI v3.1.

It's got a bunch of amazing changes in it, solving problems like the the JSON Schema <!=> OpenAPI Schema Object divergence, and fixes some other inconsistencies and duplicate ways of doing things. It's the best version and everyone should be using it, but we need tooling to catch up.

Here are a few articles showing off the differences between OpenAPI v3.0 and v3.1.

https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0
https://www.apimatic.io/blog/2021/09/migrating-to-and-from-openapi-3-1/
https://nordicapis.com/whats-new-in-openapi-3-1-0/

Seeing as most of it is about switching to generic JSON Schema tooling instead of awkwardly-different-OAS-flavoured tooling, you should be well positioned already using an existing JSON Schema validator: https://github.com/opis/json-schema. In which case, I am not sure how you were coping with the OAS != JSON Schema discrepencies already...

Anyhow, if you say you'll be working on it I can update openapi.tools to reflect that.

Let me know if you have any questions, or if you need any help with the upgrade process.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions