OpenApiSpecGeneratorPlugin omits parameters and response headers from generated specs
Los mantenedores suelen responder en 1 día
@waldekmastykarz ya está trabajando en esto.
Desde el 31/10/2026.
- #2033 de @waldekmastykarz — abierto
Evaluación
Este issue todavía no se ha evaluado.
Descripción
Description
OpenApiSpecGeneratorPlugin never emits query, header or path parameters, or response headers, in generated OpenAPI specs.
Since the move to Microsoft.OpenApi 3.x, collection properties such as OpenApiOperation.Parameters, OpenApiPathItem.Parameters and OpenApiResponse.Headers are null by default. The plugin adds to them with null-conditional calls, so every addition is a silent no-op:
DevProxy.Plugins/Generation/OpenApiSpecGeneratorPlugin.cs:321:operation.Parameters?.Add(...)(query string parameters):359:operation.Parameters?.Add(parameter)(request header parameters):430:openApiResponse.Headers?.Add(...)(response headers):558:operation.Parameters?.Add(parameter)(parametrized path segments):723:pathItem.Parameters?.Add(...)(path parameters)
OpenApiOperation (line 249) and OpenApiResponse (line 386) are created without initializing these collections.
Found while working on #1147.
Expected behaviour
Generated specs list the query, header and path parameters, and the response headers, observed in recorded traffic.
Actual behaviour
Operations have no parameters and responses have no headers.
Steps to reproduce
- Enable
OpenApiSpecGeneratorPluginand watch an API. - Record requests that use query string parameters, custom request headers and parametrized paths (for example
/users/123?$select=name), and whose responses include headers. - Stop recording and open the generated spec. Parameters and response headers are missing.
Dev Proxy Version
4.0.0 (main @ ae30e27)
Operating system (environment)
N/A (all)
Shell
N/A
Configuration file
N/A
Additional Info
Fix: initialize the collections (for example Parameters = [], Headers = new Dictionary<string, IOpenApiHeader>()) or use ??= before adding. Add tests that cover parameters and response headers in generated specs.
- Lenguaje dominante
- C#
- Estrellas
- 838
- Forks
- 90
- Merge medio
- 2 d 11 h
- PR fusionados (30 d)
- 59
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de dotnet/dev-proxy
-
GetTokenizedUrl fails on parenthesized Graph URL segmentsPosiblemente ocupada @waldekmastykarz la tomó hace 3 días. Abiertowork in progress
dotnet/dev-proxy#2041 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
Support discriminator for oneOf in OpenApiValidationPluginPosiblemente ocupada @waldekmastykarz la tomó hace 3 días. Abiertowork in progress
dotnet/dev-proxy#2040 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
Validate language-model mock output against the schema in OpenApiMockResponsePluginPosiblemente ocupada @waldekmastykarz la tomó hace 3 días. Abiertoon hold
dotnet/dev-proxy#2039 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
Support bring-your-own LLM (hosted OpenAI-compatible / Azure OpenAI) for language model integrationPosiblemente ocupada @waldekmastykarz la tomó hace 3 días. Abiertowork in progress
dotnet/dev-proxy#2034 · 1 asignado ·
Los mantenedores suelen responder en 1 día
-
breaking change on hold
Dificultad 3/5 1-2 días Aptitud para principiantes 65/100
dotnet/dev-proxy#1928 · 1 comentario ·
Los mantenedores suelen responder en 1 día
Todos los issues de dotnet/dev-proxy
Issues similares
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 78/100
QuantConnect/Documentation#2838 ·
Los mantenedores suelen responder en 1 día
-
"Create your app": .sln/.slnx step and Solution Explorer instructions don't match current C# Dev KitAbiertoarea-tutorials needs-triage
Dificultad 1/5 1-3 horas Aptitud para principiantes 72/100
dotnet/website-feedback#1844 ·
-
Needs: Attention :wave: v5 v5-preview5
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
Azure/azure-functions-core-tools#5852 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
OrchardCMS/OrchardCore#20194 ·
Los mantenedores suelen responder en 1 día
-
bug
Dificultad 2/5 1-3 horas Aptitud para principiantes 69/100
Gothic-Unity-Project/Gothic-Unity#487 ·
Los mantenedores suelen responder en 1 día