OrchardCoreContrib.Apis.Swagger
1.6.0
Prefix Reserved
dotnet add package OrchardCoreContrib.Apis.Swagger --version 1.6.0
NuGet\Install-Package OrchardCoreContrib.Apis.Swagger -Version 1.6.0
<PackageReference Include="OrchardCoreContrib.Apis.Swagger" Version="1.6.0" />
<PackageVersion Include="OrchardCoreContrib.Apis.Swagger" Version="1.6.0" />
<PackageReference Include="OrchardCoreContrib.Apis.Swagger" />
paket add OrchardCoreContrib.Apis.Swagger --version 1.6.0
#r "nuget: OrchardCoreContrib.Apis.Swagger, 1.6.0"
#:package OrchardCoreContrib.Apis.Swagger@1.6.0
#addin nuget:?package=OrchardCoreContrib.Apis.Swagger&version=1.6.0
#tool nuget:?package=OrchardCoreContrib.Apis.Swagger&version=1.6.0
Swagger Module
This module allows you to create APIs documentations using Swagger.
Version
1.6.0
Category
Api
Dependencies
This module has no dependencies.
Features
| Name | Swagger (OrchardCoreContrib.Apis.Swagger) |
| Description | Enables Swagger for OrchardCore APIs. |
| Dependencies |
| Name | Swagger (OrchardCoreContrib.Apis.Swagger.UI) |
| Description | Enables Swagger UI for OrchardCore APIs. |
| Dependencies | OrchardCoreContrib.Apis.Swagger |
NuGet Packages
| Name | Version |
|---|---|
OrchardCoreContrib.Apis.Swagger |
1.6.0 |
OrchardCoreContrib.Apis.Swagger |
1.5.0 |
OrchardCoreContrib.Apis.Swagger |
1.4.1 |
OrchardCoreContrib.Apis.Swagger |
1.4.0 |
OrchardCoreContrib.Apis.Swagger |
1.3.0 |
OrchardCoreContrib.Apis.Swagger |
1.2.0 |
OrchardCoreContrib.Apis.Swagger |
1.1.0 |
OrchardCoreContrib.Apis.Swagger |
1.0.1 |
OrchardCoreContrib.Apis.Swagger |
1.0.0 |
Get Started
- Install the
OrchardCoreContrib.Apis.SwaggerNuGet package to your Orchard Core host project. - Go to the admin site
- Select Configuration → Features menu.
Swagger
- Enable the
Swaggerfeature. - Go to the
{tenant-URL}/swagger/v1.0.0/swagger.json, you should see all the APIs listed in JSON format.
Swagger UI
- Enable the
Swagger UIfeature. - Go to the
{tenant-URL}/swagger/index.html, you should see all the APIs listed in a pretty styled page.
How to get my APIs into Swagger docs?
Adding your APIs is not swagger docs is not a difficult task, simply you need:
- Add
ApiController. - Annotate the controller with
[Route("api/{module}")]. - Add your
HttpGetorHttpPostmethods into your contoller. - Then your APIs should be displayed into the swagger docs.
So, If you tried to enable Lucene or Queries modules for instance, their APIs will show up immediately in the swagger docs. That's because every module defined an ApiController in the same way that mentioned above.
For more information about swagger, please refer to ASP.NET Core web API documentation with Swagger / OpenAPI.
Video
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. 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. |
-
net8.0
- OrchardCore.Module.Targets (>= 2.2.0)
- OrchardCoreContrib.Abstractions (>= 1.4.0)
- OrchardCoreContrib.OpenApi.Abstractions (>= 1.4.0)
- Swashbuckle.AspNetCore (>= 7.3.1)
- Swashbuckle.AspNetCore.Swagger (>= 7.3.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.