Skip to content

API Explorer Extensions Should Support Minimal APIs #812

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
commonsensesoftware opened this issue Apr 9, 2022 · 2 comments
Closed

API Explorer Extensions Should Support Minimal APIs #812

commonsensesoftware opened this issue Apr 9, 2022 · 2 comments
Assignees

Comments

@commonsensesoftware
Copy link
Collaborator

Background

When using Minimal APIs with the API Versioning API Explorer extensions, endpoints should be properly documented.

Expected Behavior

  1. IApiVersionDescriptionProvider should return expected results
  2. Route parameters should be substituted with API version value
  3. There should be parity with the built-in OpenApiRouteHandlerExtensions such as Accepts and Produces

Additional Information

  1. It would be nice to have a working example too
@commonsensesoftware
Copy link
Collaborator Author

commonsensesoftware commented Apr 9, 2022

3. Was originally excluded due to the design limitations in the current ASP.NET Core design and has been called out in dotnet/aspnetcore#39604. A fork of the code will be required to support it. Hopefully, it can be remedied in .NET 7.

@commonsensesoftware
Copy link
Collaborator Author

Fix merged and published

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant