NuGet · #885 most downloaded on NuGet

Microsoft.OpenApi.Readers

1.6.3158M downloads/moMicrosoft/OpenAPI.NET ↗New releases in your daily digest, changelog included.

OpenAPI.NET Readers for JSON and YAML documents

Last release 1 months ago
20 Aug 2026
Release timing varies
gaps range from 1 weeks to 6 months
Rarely documented
notes for 2 of 48 stable releases
12 versions withdrawn
withdrawn after publishing
127 years old
83 releases · first in 1900

Release timeline

83 releases since 1900

1900190219041906

Releases

2.0.0-preview91 Jan 1900pre-releasewithdrawnDeprecated
an issue where deprecation extension parsing would fail
Features

add support for dependentRequired (75d7a66)

Bug Fixes

an issue where deprecation extension parsing would fail (5db8757)

an issue where deprecation extension parsing would fail (b59864c)

refactor ToIdentifier() to normalize flaggable enums (#2156) (b80e934)
Open source →
2.0.0-preview81 Jan 1900

From the same repository

Microsoft/OpenAPI.NET

Microsoft.OpenApiNuGet.NET models with JSON and YAML writers for OpenAPI specification

Bug Fixes

a bug where external reference loading for local files would not work on linux (df99a00)
add meaningful exception message during validation (4a6547d)
add meaningful exception message during validation (74d20ed)
adds a cancellation token argument to external document loading (a5ffab1)
parsing failure on nodes set to null (20aacc1)
parsing failure on nodes set to null (4245de9)

Open source →

2.0.0-preview61 Jan 1900pre-releasewithdrawn

adds a net8 target to benefit from all the conditional compilation

Features

adds a net8 target to benefit from all the conditional compilation (a201aa2)
adds components registration method for schemas (10e548a)
adds deconstructor to read result (79336f6)
adds deconstructor to read result (d8c1593)
adds to identifier mapping to non nullable enum (bd9622e)
bumps target OAS version to 3.1.1 (9e8d8a4)
configure AOT for trimming compatibility (b4f9c3e)
makes document optional (754f763)
makes the reference interface covariant (7405f3c)
splits described and summarized interfaces (2a10cd9)

Bug Fixes

3.0 serialization when type is set to null (920a51a)
a bug where 3.0 downcast of type null would not work (6b636d5)
a bug where 3.0 downcast of type null would not work (ac05342)
a flaky behaviour for format property serialization (3ea1fa9)
a flaky behaviour for format property serialization (52981d4)
additional 3.1.0 constants after merge and v2 release (9e8d8a4)
adds generic shallow copy method to avoid inadvertent conversions of references to schemas (e4c14a4)
adds missing culture argument to date serialization (45329e4)
adds missing null prop operator to proxy properties (8361069)
adds missing null propagation operators for callback and header references (0cb4ccb)
adds support for all component types (8a73b54)
aligns callback parameter name with interface (68b25cc)
aligns missing properties for override (e3325b9)
aligns parameter name with interface definition for example (d7e1f91)
aligns reference copy constructors (ce93aa7)
aligns to null propagation operator (8d57b81)
allow registration of component references (14750dc)
an empty security requirement should not result in an object during serialization (1c6fd8e)
build passes (ea68427)
callback reference proxy implementation (028d60b)
callback reference proxy implementation (2cbb0fa)
components schema copy (88daad5)
conditional version for extension causes invalid json (4030c1f)
conditional version for extension causes invalid json (0ce92cc)
date time and date time offset shifting zones (a6a44a7)
default settings in case of null value (ab2ddf0)
do not allow null argument for example copy constructor (aa80b19)
do not copy host document as it negatively impact performance (1043e4e)
do not copy host document as it negatively impact performance (a46e857)
do not emit a type array in 3.1 when unnecessary (3b3d0e6)
draft security scheme reference proxy design pattern (1bd2624)
empty security requirements are actually valid. to negate the document ones (42bd396)
enum description number values (ff7b4a9)
enum description number values (e29e24c)
enum parsing when encountering unknown values should not default to first member (d4e155b)
enum parsing when encountering unknown values should not default to first member (9d07ebb)
extensions collection initialization (4f28b65)
extraneous null prop removal (1006879)
failing unit test after merge (a4ac872)
failing unit tests for security scheme references in security requirements (d2e4111)
fixes inlining override when they should not happen (704943c)
fixes invalid OAI document for unit tests (837f000)
inconsistant API surface usage (47ad76b)
last reference to copy constructor (d87375d)
makes reference fields immutable (fda05d4)
makes reference of holder immutable (a182f44)
makes target field read only (89881fd)
missing defensive programming in copy constructors (227d99d)
missing doc comment for annotations (41759a1)
missing null prop operator on parameter reference (019eb99)
missing property rename (2443fa0)
multiple performance fixes for type serialization (bd9622e)
multiple performance fixes for type serialization feat: adds to identifier mapping to non nullable enum (5fef51c)
multiple unit test failures (2f171a3)
null flag comparison (081e251)
null propagation for most failed reference lookup (7994691)
null reference check (a5023d6)
Open API header proxy design pattern implementation (77e0ad1)
open API link reference proxy design pattern implementation (6a96462)
open API link reference proxy design pattern implementation (376e54d)
open api response reference should not clone objects (4243873)
open api schema reference proxy design pattern implementation (e57d049)
open api schema reference proxy design pattern implementation (aebefb7)
parameter reference proxy design pattern implementation (ed6ffa1)
parameter reference proxy design pattern implementation (eeb79a4)
passes missing host document references to all layers (d7c4621)
passes missing host document references to all layers (ff1406c)
path item reference implementation (56f291b)
path item reference implementation (c725267)
potential NRT (9db6e2d)
potential NRT for net8 build (f517deb)
proxy design pattern implementation for OpenAPiExample (cc28ff2)
proxy design pattern implementation for request body (425335e)
references callback writer (88ad997)
removes all obsolete APIs (e861c08)
removes extraneuous null prop op in copy constructor (227d99d)
removes nullable property that shouldn't be part of dom (4d9c17b)
removes redundant assignment (8d70195)
removes unnecessary null prop in copy constructor (aa993b1)
removes unused parameters (de9d979)
removes unused parameters (9cd7aae)
removes useless condition for null check (4a50c77)
removes useless virtual definitions in components (af3038a)
removes virtual modifier in MediaType (4dfc9b8)
request body references are converted to v2 properly (b84ea19)
response reference proxy design pattern implementation (8103c20)
response reference proxy design pattern implementation (5b4003b)
restores default constructor for ISerializable implementation (778184f)
returns reference instead of null (45e40fa)
sets hidi version to a preview (975b1bf)
sets hidi version to a preview (8999336)
shallow copy for callback (4ea87ef)
shallow copy for example (9bc3044)
shallow copy for parameter link path item and request body (9af6f30)
side effects in tag references (717deb0)
side effects in tag references (878593b)
single copy and maintain for references (30ee6ed)
specifies encoding for net fx (95dafe6)
specifies encoding for net fx (cd13481)
support non-standard MIME type in response header (50ddca2)
switches header to shallow copy (2a42c36)
tag reference proxy design pattern implementation (46e08d4)
tag, response, and security scheme shallow copy (7ac149c)
updates public api file (b727581)
updates public API surface with net8 target (1a1e013)
uses backing fields instead of schema copy (6f4e7a2)
uses the json node clone API to avoid unecessary allocs (818414d)
v2 references for properties do not work as expected (aa90edf)
v2 references for properties do not work as expected (ec9c01b)
v2 request body content null propagation (6d064c4)
v2 request body content null propagation (8b4833c)
visibility of serialize internal methods (dc8a757)

Performance Improvements

avoid round trip serialization (a6a44a7)

Open source →

2.0.0-preview101 Jan 1900pre-releasewithdrawn

deduplicates tags at the document level

Features

deduplicates tags at the document level (93c468e)
tags references are now deduplicated as well (763c0c1)

Bug Fixes

add logic for serializing date time objects (23395c5)
adds missing cancellation parameter to async method (243a111)
avoid creating new http clients to load additional documents of the workspace (0f23798)
deduplicates exclusive min/max properties in the object model (08414a1)
deduplicates exclusive min/max properties in the object model (0d5b471)
moves the http client for the reader to settings so it can be passed by client application (9b910f3)
OpenAPIDocument JsonSchemaDialect property is now a URI (45977b5)
openapischema schema property is now a Uri (452a6b9)
primitive parsing for strings as DateTimes is too greedy (4ee1d8b)
removes static readers registry (fe7a2fd)
use a single http client in hidi (9386fae)