EAC.Infrastructure.Api.JsonApi.OpenApi
0.1.0-rc.4
dotnet add package EAC.Infrastructure.Api.JsonApi.OpenApi --version 0.1.0-rc.4
NuGet\Install-Package EAC.Infrastructure.Api.JsonApi.OpenApi -Version 0.1.0-rc.4
<PackageReference Include="EAC.Infrastructure.Api.JsonApi.OpenApi" Version="0.1.0-rc.4" />
<PackageVersion Include="EAC.Infrastructure.Api.JsonApi.OpenApi" Version="0.1.0-rc.4" />
<PackageReference Include="EAC.Infrastructure.Api.JsonApi.OpenApi" />
paket add EAC.Infrastructure.Api.JsonApi.OpenApi --version 0.1.0-rc.4
#r "nuget: EAC.Infrastructure.Api.JsonApi.OpenApi, 0.1.0-rc.4"
#:package EAC.Infrastructure.Api.JsonApi.OpenApi@0.1.0-rc.4
#addin nuget:?package=EAC.Infrastructure.Api.JsonApi.OpenApi&version=0.1.0-rc.4&prerelease
#tool nuget:?package=EAC.Infrastructure.Api.JsonApi.OpenApi&version=0.1.0-rc.4&prerelease
EAC.Infrastructure.Api.JsonApi.OpenApi
Desde 2026-10-09, Native AOT queda fuera del alcance por decisión del usuario. No se declara compatibilidad ni se exige su gate. Las referencias históricas no constituyen soporte vigente; build y tests ordinarios siguen siendo obligatorios.
Repositorio propietario del NuGet
EAC.Infrastructure.Api.JsonApi.OpenApi.
Estado actual: implementación funcional y CI remoto verificados con Pipeline
Catalog v0.4.4; 0.1.0-alpha.2, 0.1.0-beta.1 y 0.1.0-rc.2 están
publicados en NuGet.org. La promoción estable permanece fuera del alcance
autorizado.
La ampliación en desarrollo permite describir JSON simple y JSON:API para el
mismo endpoint mediante WithNegotiatedResponses, compartir errores mediante
WithNegotiatedErrors y declarar 204 mediante WithNegotiatedNoContent.
Se consume con referencias de proyecto; todavía no se ha publicado en NuGet.
Los contratos anteriores exclusivamente JSON:API conservan su comportamiento.
- Índice documental
- Guía de consumo y configuración
- Diseño
- Plan de implementación
- Arquitectura transversal
Instalación y consumo
<PackageReference Include="EAC.Infrastructure.Api.JsonApi.OpenApi" Version="0.1.0-rc.2" />
El paquete extiende directamente las opciones oficiales de ASP.NET Core:
builder.Services.AddOpenApi("v1", options =>
{
options.AddJsonApiTransformers();
});
La publicación del documento pertenece al host y puede condicionarse con la configuración ambiental nativa de ASP.NET Core:
if (app.Environment.IsDevelopment())
{
app.MapOpenApi();
}
Este paquete no posee una sección en appsettings.json, variables de entorno,
secretos, conexiones, opciones recargables ni recursos externos. Por tanto, no
se debe inventar una sección Eac:Api:JsonApi:OpenApi. La configuración general
del documento, su ruta y su exposición se realizan con OpenApiOptions,
MapOpenApi y las fuentes nativas del host.
| Decisión | Mecanismo propietario | Momento |
|---|---|---|
| Activar los transformers JSON:API | AddJsonApiTransformers() |
composición del host |
| Declarar recursos, operaciones y responses | metadata tipada del endpoint | código/build |
| Configurar el documento OpenAPI | OpenApiOptions |
composición del host |
Exponer o restringir /openapi |
MapOpenApi y entorno/autorización del host |
startup/runtime |
| Incorporar Scalar u otra UI | dependencia directa del servicio | composición del host |
La metadata inválida falla durante la generación del documento y debe formar parte de las pruebas/build del servicio. No existe configuración programática duplicada ni un binder propio del componente.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- EAC.Infrastructure.Api.JsonApi (>= 0.1.0-rc.4)
- Microsoft.AspNetCore.OpenApi (>= 10.0.12)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-rc.4 | 68 | 10/23/2026 |
| 0.1.0-rc.2 | 87 | 8/21/2026 |
| 0.1.0-rc.1 | 90 | 8/16/2026 |
| 0.1.0-beta.1 | 87 | 8/16/2026 |
| 0.1.0-alpha.2 | 93 | 8/16/2026 |