OpenAPI 3.1 is out!!!

[gregsdennis]

The OpenAPI v3.1 spec has been released! 🎉

We want all the updates! 🎉 🎉

[darrelmiller]

:-) We need to get the 1.3 milestone out and then we can focus on supporting 3.1.

We should definitely chat about how we can integrate well with whatever replaces Manatee. I also want to get System.Text.JSON support into this library. The perf difference for large documents is huge.

[gregsdennis]

https://github.com/gregsdennis/json-everything
https://www.nuget.org/packages/JsonSchema.Net/

This is the new library suite that replaces Manatee.Json. It's fully supported by System.Text.Json. (Turns out taking my parsing/serialization logic out made things a LOT faster.)

I'm currently working on a JSON Schema extension lib that will perform the OpenAPI schema validations. I'm just waiting for the meta-schema to be released. Ideally, if it passes validation, it should just deserialize into your models without any problems.

[darrelmiller]

@gregsdennis Have you seen the PR Jason Desroisier wrote? OAI/OpenAPI-Specification#2489 We reviewed it in the last TSC meeting and it is looking really close.

[gregsdennis]

Yeah, I'm part of that discussion in Slack. He's kind of our rep for right now. It's better than having 50 JSON Schema implementors yell at OAS.

[gregsdennis]

So discussions over at the OAI group have yielded that the new keywords are to be annotations only (which would be pretty easy to implement). I might add in optional validation for discriminator, but I'm not sure yet.

[ygalbel]

Hi,
We are using this library heavily.
We are working on a project that need support for Webhooks that are a part of OpenAPI 3.1.

Do you have date that you think we will be able to use it?
Thanks again for this great library

[gregsdennis]

So I had a look at implementing the new keywords. Turns out OAS is saying that they're officially annotation-only, which means that there's nothing to validate. I think there's still some discussion going on regarding the meta-schema and maybe a vocabulary ID, so if anything I'd need to make an extension lib for that.

@darrelmiller I'm happy to help build in the schema support when you're ready to work on this.

[darrelmiller]

Once I get the build pipeline fixed I can get this release out and start focusing on 3.1 support.

[ygalbel]

Thanks a lot.

Do I have to help and push it?

[gregsdennis]

Do I have to help and push it?

I think you mean, "Would it help if I got out and pushed?"

[darrelmiller]

the 1.3.0-preview almost went out on Sunday night and then I discovered the Nuget API key had expired and I need someone else to fix that. Hopefully today.

[qub1n]

Guys, are you going to support OpenAPI v3.1 or not? This ticket is opened for two and half year already.