如何在asp.net中使用swagger呈现本地json规范？
在asp.net中使用Swagger呈现本地JSON规范的步骤如下：
- 确保你的ASP.NET项目已安装了Swagger NuGet包。可以通过NuGet包管理器或在项目文件中手动添加引用来安装。
- 在Global.asax.cs文件中，添加以下代码来启用Swagger API文档生成：
protected void Application_Start()
{
// 启用Swagger
GlobalConfiguration.Configuration
.EnableSwagger(c => c.SingleApiVersion("v1", "API名称"))
.EnableSwaggerUi();
}- 创建一个名为
SwaggerConfig.cs的新文件，并将其添加到App_Start文件夹中。在该文件中，添加以下代码来配置Swagger生成规范和注释：
using System.Web.Http;
using Swashbuckle.Application;
namespace YourProjectNamespace
{
public class SwaggerConfig
{
public static void Register(HttpConfiguration config)
{
// 配置Swagger生成规范
config.EnableSwagger(c =>
{
c.SingleApiVersion("v1", "API名称");
c.IncludeXmlComments(GetXmlCommentsPath());
}).EnableSwaggerUi();
}
// 获取XML注释文件的路径
private static string GetXmlCommentsPath()
{
return System.String.Format(@"{0}\bin\YourProjectNamespace.XML",
System.AppDomain.CurrentDomain.BaseDirectory);
}
}
}- 打开
Global.asax.cs文件，并在Application_Start方法中注册Swagger配置，代码如下：
protected void Application_Start()
{
// 启用Swagger
SwaggerConfig.Register(GlobalConfiguration.Configuration);
}- 在项目的Properties文件夹中，找到
AssemblyInfo.cs文件，并添加以下代码以生成XML注释文件：
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;
[assembly: AssemblyTitle("YourProjectNamespace")]
[assembly: AssemblyDescription("")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("")]
[assembly: AssemblyProduct("YourProjectNamespace")]
[assembly: AssemblyCopyright("")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]
// 添加下面这行代码
[assembly: System.Web.Http.Cors.EnableCors("*", "*", "*")]
// 生成XML注释文件
[assembly: System.Web.Http.Cors.EnableCors("*", "*", "*")]
[assembly: ComVisible(false)]
[assembly: Guid("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")]
[assembly: AssemblyVersion("1.0.0.0")]
[assembly: AssemblyFileVersion("1.0.0.0")]- 在Visual Studio中，右键单击项目并选择“属性”，在“生成”选项卡下，确保“XML文档文件”选项已勾选，然后重新生成项目。
- 启动ASP.NET应用程序，浏览到Swagger UI的URL（通常为
http://localhost:<port>/swagger）即可查看生成的API文档和JSON规范。
需要注意的是，此方法使用的是ASP.NET的Swagger框架和工具。腾讯云的相关产品和链接地址可根据自己的需求和云服务商选择。
相关·内容
2回答
我使用AWS网关创建了API。然后，我记录了所有实体的文档部分(如API、资源、方法、模型等)。然后，使用AWS控制台，我将文档发布到dev阶段，并使用1版本
但我不确定我(或API的使用者)如何访问文档？
有一个Export选项可以将文档导出为Swagger或OpenAPI3。这将创建.json或.yaml文件，然后消费者必须将这些文件导入swagger。但是，这并不是用户友好的选择，每次我更新文档给所有消费者时都会提供swagger文件。
我想知道，在发布文档之后，无论如何，消费者可以通过http直接访问文档。因此，让我们假设我的dev阶段api是https://devapi.exampl
浏览 2提问于2019-01-15得票数 21
18回答
我试图在本地计算机上使用打开我自己生成的swagger规范文件。
因此，我最新的标签v2.1.8-M1并解压拉链。然后我进入子文件夹dist并将文件my.json复制到其中。现在，我打开了index.html，并想探索my.json。问题就从这里开始：
如果我输入一个本地路径，它总是以包含index.html的当前url作为前缀。所以我不能打开我的文件。我尝试了以下所有组合，但都没有成功：
my.json通向file:///D:/swagger-ui/dist/index.html/my.json
file:///D:/swagger-ui/dist/my.json通向f
浏览 51提问于2015-05-22得票数 81
回答已采纳
我有一个json规范(webapi.json)，并希望使用swashbuckle呈现相同的规范。有什么方法可以做到这一点吗？ 我的configure方法如下所示 public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseMv
浏览 13提问于2019-03-18得票数 1
回答已采纳
我正在使用Swagger测试Asp.Net核心应用程序中的API。我通过输入类似于这个Authorization: Bearer {token}的令牌来发送请求。但是授权头不是在请求中发送的。
Asp.Net核心版本3.1和Swashbuckle.AspNetCore 5.4.1
Startup.cs代码：
public class Startup
{
private const string _apiVersion = "v1";
public Startup(IConfiguration configuration)
{
Config
浏览 3提问于2020-05-29得票数 6
回答已采纳
我正在尝试使用https://github.com/swagger-api/swagger-codegen生成nodejs client sdk，下面是我使用的命令 swagger-codegen generate -i http://petstore.swagger.io/v2/swagger.json -l javascript -o ./petstore 但是对于我需要生成的实际sdk，swagger规范被分成两个不同的json文件，我想为这两个文件创建一个单独的sdk。我如何使用Swagger-codegen，同时使用多个swagger json来做这件事？
浏览 24提问于2019-03-20得票数 2
我在应用程序中嵌入了swagger ui。当我在本地运行我的节点应用程序时，UI工作得很好。
然而，当我将UI部署到我的‘真正的’服务器上时，我在我的swagger ui的右下角得到了一个错误图像：
我确信这是我正在做的事情，把它搞砸了，但我不知道。当我通过http访问swagger ui时，再次在本地工作。
但是，当我部署时，我通过apache运行并通过https服务，我看到了一个错误。更糟糕的是，我的“Try it”调用在部署时都不起作用。看起来这个请求并没有被提出。
看起来UI使用我的swagger.json调用了一个验证器，但是该调用在本地工作。
我做错了什么？
当我单击错误
浏览 0提问于2015-01-07得票数 41
1回答
Swagger grails集成
、、、、
我是新的swagger，我想集成swagger到Restful API项目使用grails框架。如果有人知道我做错了什么，请帮助我？
我的grails规范如下：
| Grails Version: 3.0.7
| Groovy Version: 2.4.4
| JVM Version: 1.8.0_71
对swagger进行了如下设置：
在build.gradle中：
dependencies {
...
compile "io.swagger:swagger-core:1.5.3"
compile
浏览 4提问于2017-05-16得票数 0
我们有一个包含两个项目的.NET解决方案：
ASP.NET MVC门户项目
OWIN Host项目(带有自定义控制器选择器)
我们试图向基于自己的API项目中的几个API控制器公开一个公共文档，我们想在API项目中展示Portal项目中用于控制器的Swagger UI。
到目前为止，所有的尝试都没有成功。当将Swagger添加到Portal项目时，它只想显示关于Portal项目中的控制器的文档，而不是来自API项目的文档。
当向API项目添加Swagger (不是首选解决方案)时，它根本不工作，可能是因为自定义控制器选择器
然而，我想我错过了一些显而易见的东西，因为这感觉就像我
浏览 7提问于2016-04-13得票数 5
因此，我想运行关于Local的本地Swagger 。为此，我遵循可用的指令
下面是在该文档中共享的命令：
docker run -p 8081:8080 -e SWAGGER_JSON=/foo/swagger.json -v /bar:/foo swaggerapi/swagger-ui
在这里，我理解-p选项，但是这个-e和-v令人困惑。
因此，让我们假设在Mac中的桌面上保存了一个JSON文件，其路径是：
因此，对于这个文件，命令将更改为：
docker run -p 8081:8080 -e SWAGGER_JSON=/Users/abc/Desktop/lp.json -v /bar
浏览 0提问于2018-04-14得票数 20
回答已采纳
1回答
如何在windows上本地运行swagger文件？我知道我们可以在上试用它，但是我把swagger文件分割成多个文件，所以我想知道如何在windows上运行它。
浏览 3提问于2022-01-04得票数 0
1回答
我使用的是ASP.NET Core2.0和Swashbuckle.AspNetCore (2.4.0)
在启动ConfigureServices中
services.AddSwaggerGen(c =>
{
c.OperationFilter<AuthorizationHeaderParameterOperationFilter>();
c.SwaggerDoc("v1", new Info
{
Version = "v1",
浏览 2提问于2018-06-04得票数 2
回答已采纳
3回答
我想在我的ReDoc中添加一些额外的选项。对于当前的实现，我使用从Swagger生成的json文件，并将其添加到html页面中。例如，如何做到这一点：
<body>
<redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
<script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
浏览 0提问于2018-10-11得票数 3
回答已采纳
当我们将NSwag与ASP.Net核心服务的默认设置一起使用时(它改变了HttpSys侦听器url (添加了路径后缀))，生成的swagger.json和UI (未找到/访问)。
设置HttpSys侦听器的url路径：
protected override IEnumerable<ServiceInstanceListener> CreateServiceInstanceListeners()
{
return new ServiceInstanceListener[]
{
new ServiceInstanceLis
浏览 2提问于2018-11-07得票数 0
在Startup.cs中配置以下代码
变量。
private const string SwaggerDocumentVersionName = "v1";
private static string SwaggerDocumentServiceName => $"Users API({SwaggerDocumentVersionName})";
ConfigureServices方法。
services.AddSwaggerGen(c =>
{
c.SwaggerDoc(
SwaggerDocumentVersionName
浏览 9提问于2020-05-14得票数 1
回答已采纳
2回答
当您在VisualStudio2022中创建一个并在本地测试它时，您将获得Swagger接口或ASP.NET (不管它叫什么)来测试所有HTTP。在我看来非常方便，因为我不太喜欢邮递员界面。
但是，当我部署Web时，尝试访问{path}/swagger将返回一个404 Not Found错误，即使它对本地主机有效，当API和数据库都位于我自己的计算机上时。即使数据库在Azure云中，如果我将字符串放入appsettings.json中，它也能工作。
那么，是否有办法更好地做到这一点，而不需要太多的麻烦呢？或者我想要这样做是错误的，开发人员是否大部分是在本地测试他们的API？因为我只想让Swag
浏览 6提问于2022-03-16得票数 1
1回答
威格和json-rpc
、、、
我试图在我的json服务器上使用Swagger，它是由php编写的。我使用为Swagger生成json投诉容器。因此，我对Swagger非常陌生，我使用注释的方法如下：
/**
* @SWG\Resource(
* apiVersion="0.2",
* swaggerVersion="0.8",
* basePath="http://mydomain.com",
* @SWG\Api(
* path="/rpc/json/server.php",
*
浏览 2提问于2013-10-27得票数 1
当将AWS的API网关文档导出到Swagger时，我遇到了问题。对于具有空类型的JSON模型，我有一个文档部分，如：
{
"title": "Incident",
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"createdAt":
浏览 5提问于2018-12-03得票数 6
所以现在的默认值是：/v2/api-doc。
如何将swagger配置为/v2/swagger.json
我不知道怎么找到财产档案。
解决方案是在.yml文件中添加注释：
springfox:
documentation:
swagger:
v2:
path: /v1/swagger.json
浏览 2提问于2018-07-05得票数 0
1回答
我正在尝试将自定义属性添加到生成的swagger.json的info部分。我发现很多文章都在讨论如何在json中添加属性，方法是在它们前面加上"x-“。(例如：https://swagger.io/specification/#specification-extensions) 但是，我找不到任何说明如何通过C#代码做到这一点的东西。(当前使用的是.NET 5) 我们目前将标准属性设置如下： options.SwaggerDoc(Swagger.Version, new OpenApiInfo
{
Title = "Service Api",
Version
浏览 33提问于2021-08-27得票数 0
1回答
我通过使用他们的dockerize图像在本地成功地运行了swagger-ui和swagger-editor，这是我的docker-compose.yml。
swagger-editor:
image: swaggerapi/swagger-editor
container_name: "swagger-editor"
ports:
- "8081:8080"
networks:
- eb-back_network
swagge
浏览 1提问于2020-12-23得票数 0
我使用ASP.NET核心和NSwag来托管和描述一个新的带有的IIS服务。
在本地，我使用https运行web服务，但是当我部署到测试环境时，web服务位于带有SSL卸载的负载均衡器后面。这意味着，即使站点在浏览器中似乎在SSL下运行，IIS中的实际绑定是http。因此，我的Swagger页面(和swagger.json定义)将支持的方案描述为http。
我希望使用Swagger.json中的Scheme元素来读取"https“而不是"http”。有人能帮我找到我需要在代码中设置的属性来手动设置方案吗？
{
x-generator: "NSwag v11.19.
浏览 1提问于2018-10-03得票数 6
回答已采纳
作品可以在本地找到。使用ASP.NET核心3.1
发布到dev我注意到swagger只有HTTP选项，当我在下面得到的服务上尝试GET时？
是不是开发服务器上的某些东西导致了我需要更改？
SEC7111:混合内容源'‘已在安全上下文中加载，但试图在'’处加载不安全的资源。
无结果
浏览 0提问于2020-01-29得票数 2
我们将APIM实例部署为外部实例，但可以访问部署在VNET中的后端服务。这些服务只能从该VNET内访问。
现在，我们正在尝试使用Swagger文件的URL (如：)添加一个新的OpenAPI规范。
我们实际上在本地生成了swagger文件，并通过选择该文件将其上传到规范中，并且它起作用了。所以json是有效的。当我们输入文件的URL时，它不起作用，正如我所说的，它不是公开的。
我们可以使用内部URL添加OpenAPI规范吗？
非常感谢并致以问候，
P
浏览 4提问于2018-11-28得票数 1
我使用的是swagger-spring 0.9.5，在响应数据中有这样的字段：
@ApiModelProperty("Some description")
private List<Account> accounts;
问题的简短版本：如何从这个带注释的Java到目标C，通过swagger-codegen?？
由此生成的傲慢的JSON是：
accounts: {
description: "Some description",
items: {
type: "Account"
},
required: fals
浏览 6提问于2015-05-07得票数 4
回答已采纳
我正在通过Carma swagger-jaxrs-doclet.在maven构建周期期间生成swagger service.json和其他resource.jsons。之后，我将工件与swagger一起部署到can服务器上，并可以查阅生成的文档。这意味着我不会在我的应用程序中部署一个傲慢的bean！
由于swagger主要是沿API实现部署的，所以我想知道swagger-ui采用哪种方法来使docs可执行。它是从swagger-ui文档重定向到真正的实现，还是基于service.json创建模拟后端？我已经读到，在node.js中创建一个基于service.json的后端是可能的，但我不知道如
浏览 1提问于2014-09-24得票数 2
回答已采纳
我正在尝试使用本地swagger.json文件在swagger文档中显示。
我的swagger.json文件位于/home/user1/swagger-ui/dist/swagger.json下，index.html位于同一目录下。我对index.html进行了如下修改。
window.swaggerUi = new SwaggerUi({
spec: ../swagger.json
url: url,
dom_id: "swagger-ui-container",
使用docker run -p 80:8080 swagger-ui-builder启
浏览 3提问于2016-07-11得票数 3
3回答
我已经在我的Web (ASP.NET Core3.1)中实现了Swagger，我的启动url是/swagger。我已经按照这个顺序编辑了我的launchSettings.json，它在我的开发机器上工作得很好，但在产品服务器上发布之后就不行了。
我读到launchSettings.json只在本地开发机器上使用，如果我想在生产机器上使用这些设置中的某些设置，我需要将这些设置存储在appsettings.json文件中。
但是我找不到如何设置这个文件。如果能帮上你的忙，我会很感激的。
浏览 3提问于2021-07-19得票数 0
2回答
单用摇瓶
、、、
我已经发现Swagger可以为我开发的Restful Api生成文档，但问题是我只使用了烧瓶而不是烧瓶-restful，当我尝试使用烧瓶-restful-swagger包装时，它不起作用，例如：
from sqlalchemy.orm import create_session
from flask import Flask, request, jsonify
from Model import *
from flask_restful import Api
from flask_restful_swagger import swagger
app = Flask(__name__)
a
浏览 15提问于2014-11-18得票数 3
我正在编写OpenAPI3.0规范，并试图让在SwaggerUV3.18.3中呈现。
示例：
openapi: 3.0.0
info:
title: Test
version: '1.0'
tags:
- name: Artifacts
paths:
/artifacts:
post:
tags:
- Artifacts
operationId: createArtifact
requestBody:
content:
application/octet-stre
浏览 0提问于2019-04-24得票数 11
回答已采纳
在Swagger文件中，默认情况下这两种响应格式都包括JSON:API和application/json。
这会导致生成Java类时出现问题，并阻止客户端编译。
我用两个不同的编译器测试了这个
Swagger代码生成器3.0.35 以及
不同版本的OpenAPI生成器。
作为解决办法，Swagger文件目前必须手动调整，JSON:API格式必须删除，这将导致更新期间的大量工作。
Swagger文件的生成是否可能只包含格式应用程序/json
浏览 1提问于2022-10-17得票数 0
回答已采纳
托管了我的asp.net核心1.2应用程序后，我收到一个错误，如下所示：
swagger无法找到swagger.json文件。
我试图通过给出一个虚拟路径名app.UseSwaggerUI()来解决这个问题，但是它不起作用。
编辑基于评论澄清问题：
在IIS中承载Asp.net核心应用程序之后，swagger.json文件将在localhost:<random_port>/swagger/v1/swagger.json路径上生成。
如何在自定义路由(如：swagger.json )上为localhost:<random_port>/virtualpathname
浏览 3提问于2017-07-21得票数 1
回答已采纳
我有一个场景，其中POST方法返回"image/png“内容。这个API在邮递员中运行得很好，我可以看到一个图像。
我使用Swagger来记录我的API。由于某种原因，“尝试”功能使返回图像的POST方法崩溃。它在加载时冻结，我在浏览器控制台中看到以下内容：
cannot parse JSON/YAML content
swagger-ui-min-js:14 Uncaught TypeError: Failed to execute 'createObjectURL' on 'URL': No function was found that matc
浏览 8提问于2017-07-20得票数 3
回答已采纳
1回答
我在我的web项目中使用Swashbuckle包，我试图用这个替换默认的Swagger
但我一直收到这条错误信息
<?xml version="1.0" encoding="ISO-8859-1"?>
<Error>
<Message>An error has occurred.</Message>
<ExceptionMessage>Embedded resource not found - ReportsAPI.swagger-ui.Index.html</ExceptionMessage&g
浏览 0提问于2019-05-09得票数 0
回答已采纳
我是用TypeScipt编写的一个项目的一部分，我试图添加TypeScript Web，它将与Swagger兼容。
考虑到易维护性，实现它的最基本策略是什么？
对于类型记录，我注意到存在“Typson”库，用于从Typescript接口生成JSON模型。
对于Swagger，我尝试使用‘swagger -’库，因为它支持向swagger添加JSON模型。
不过，我遇到了一些问题：
Typson不支持导入typeScript 语法- (import {Server} from "restify")
我尝试实现'swagger-node-restif
浏览 2提问于2016-03-07得票数 10
2回答
我有Swagger UI for API文档，我使用了与相同的方法来访问它，我使用了next URL：
http://localhost:9000/docs/swagger-ui/index.html?url=/assets/swagger.json
但是我想用http://localhost:9000/docs/代替。我不想使用WS进行委托，我想在routes中使用一行，如下所示：
GET /docs controllers.Assets.at(path:String="/public/lib/swagger-ui", file:String="index.html?
浏览 7提问于2017-10-06得票数 4
回答已采纳
1回答
我有一个带有asp.net的vue.js核心应用程序。我制作了网络api。当我通过本地主机进行调试时，一切都很好。Swagger正在工作，也作为应用程序使用。但是当我将应用程序部署到IIS时，Swagger不工作，并显示404错误。
下面是Startup.cs中的swagger配置
services.AddSwaggerGen(config =>
{
var xmlFile = $"{System.Reflection.Assembly.GetExecutingAssembly().GetName().Name}.xml";
浏览 4提问于2022-01-22得票数 1
回答已采纳
2回答
我正在为其编写Swagger 2.0规范的API基本上是任何JSON值的存储。
我想要一个读取值的路径和一个存储任何非预定义深度的JSON值(null、number、integer、string、object、array)的路径。
不幸的是，Swagger 2.0似乎对输入和输出的模式非常严格，并且不允许JSON Schema所允许的整个模式集。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。
因此，我尝试通过定义一个MixedValue模式来解决这个问题：
---
swagger: '2.0'
info:
浏览 2提问于2015-09-29得票数 9
回答已采纳
我试图为SecurityDefinition构建Swagger设置，以便在openapi.json中获得以下结果：
"securityDefinitions": {
"password": {
"type": "oauth2",
"tokenUrl": "http://example.com/oauth/token",
"flow": "password",
"scopes": {
"write&
浏览 7提问于2017-01-20得票数 6
回答已采纳
我有一个简单的jq命令&当我在本地计算机上运行它时，它可以工作。二进制文件不会更改。
jq 'query.....' $srcJson > $destinationJson
当Jenkins在单独的Windows计算机上运行上述命令(位于Powershell文件中)时，$destinationJson二进制文件已经更改。
例如：
bad-swagger.json文件是在Jenkins创建的。
swagger.json文件在本地PowerShell窗口中创建。
这两个文本文件都有相同的内容，但是文件大小相差两倍& giff diff显示二进制文件是
浏览 4提问于2021-05-12得票数 2
回答已采纳
1回答
我使用NSwag SwaggerToCSharpClientGenerator来生成请求和响应类以及枚举。
我有一些Web API方法，它们共享相同的枚举作为参数或请求对象的一部分。当我运行枚举API时，它多次生成相同的枚举定义，但命名为Enum1、Enum2、Enum3、ResponseClassEnum。
我可以配置NSwag (或Swashbuckle)，只生成一个枚举吗？
我的NSwag代码如下所示：
var document = SwaggerDocument.FromUrlAsync(
"http://localhost:5003/swagger/v1/s
浏览 1提问于2017-09-17得票数 2
在我的asp.net核心2.1API中，我添加了服务和.json的静态文件，但是显然找不到生成的.json
services.AddSwaggerGen(x =>
x.SwaggerDoc("Swagger", new Info { Title = "Asp.Net Core 2 Api", Description = "Swagger Core Api" }));
----
app.UseCors("AllowAll");
app.UseAuthentication();
app.UseStaticFiles();
浏览 0提问于2018-10-18得票数 4
回答已采纳
我有一个具有以下模式的API网关： {
"swagger": "2.0",
"info": {
"description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). F
浏览 15提问于2021-03-24得票数 2
回答已采纳
我们正在为我们的CI-CD使用代码管道。
前端和后端是独立的存储库。
我们对前端和后端的部署进行了端到端的测试。
代码从特性分支-> dev ->暂存-> prod合并，并启动各自的管道。
我期待着整合合同测试。在部署API网关时，我们已经生成/存储了swagger文档。
我认为，为了模拟消费者驱动的合同测试，在部署前端或后端的end 2端测试成功执行之后，我将从API网关下载swagger JSON文档，并将其存储在s3桶中，以便我可以使用它作为参考来检测开发/准备阶段的中断更改。
我应该比较dev和staging以prod来检测破坏的更改吗？我不喜欢在部署到dev或暂存时
浏览 0提问于2021-10-28得票数 3
如何向SwaggerUI添加swagger.json文件？到目前为止，我只能生成一个，并且它会在webapp中自动“引用”它自己，我可以从/ swagger /v1/swagger.json调用它，我能找到的唯一帮助是关于url根，但是swagger如何在你的项目中找到规范呢？
我还可以将多个.json文件添加到SwaggerUI中，文档中说可以这样做
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "SwaggerDemo v1");
浏览 9提问于2020-02-24得票数 0
我正在尝试在本地运行一个停靠器中的swagger，并让它使用我的swagger.yaml文件。Swagger文件放在这里，${pwd}/foo/swagger.yaml
我尝试的是运行这个命令，但是我只获得默认的petstore示例，而不是本地的swagger文件。
下面是docker命令
码头运行-p 8085:8080 -e SWAGGER_JSON=/foo/swagger.json -v pwd:/foo swaggerapi/swagger-ui
浏览 3提问于2020-04-27得票数 0
我在googled上搜索了一点，以找到一种合适且易于实现的方法，为现有的Rails API应用程序生成文档。简而言之，有两种实现方式:通过控制器、模型或通过Rspec控制器/请求规范。清单不长，作出选择也不那么容易：
宝石，-最古老的优点:实现要在控制器中完成。缺点:不支持Swagger V2版本，仅限于1.2。
gem，改进版本的swagger-docs，支持Swagger V2版本，实现将在控制器、模型中完成。但是我无法使它工作，无法解析生成的json文件。
gem:使用基于Swagger的DSL扩展rspec“请求规范”。就我个人而言，我发现在现有的Rails应用程序中实
浏览 0提问于2018-12-04得票数 6
我有一个带有swagger的ASP.net核心web (使用swashbuckle)。
Web API中的一个操作是文件上载操作：
[Produces("application/json")]
[Route("[controller]")]
public class FilesController : Controller
{
[HttpPost]
public void Post(IFormFile file)
{
...
}
}
当我在swagger中查找该操作时，让我填写IFormFile的所有字段，这不是我
浏览 0提问于2018-05-04得票数 5
回答已采纳
拥有主JSON文件
{"swaggerVersion":"1.2",
"apiVersion":"1.0",
"apis":[{"path":"/api1"},{"path":"/api2"},{"path":"/api3"},{"path":"/api4"}]}
4个API中的每个API的JSON文件，每个API都能很好地与Swagger库一起工作。
但是当我试图将所有这些放到一个J
浏览 1提问于2014-08-08得票数 10
我正在IIS服务器上部署我的.net核心应用程序，并且在swagger.json找不到的情况下，我要面对这个问题。当我在本地运行它(开发环境)时，一切都很完美，但是当我在IIS服务器上部署它时，它无法找到swagger.json文件。
以前，我在.net核心2.1应用程序中遇到了这个问题，我通过编写下面的代码来获得虚拟基本路径来解决这个问题。
string basePath = Environment.GetEnvironmentVariable("ASPNETCORE_APPL_PATH");
basePath = basePath == null ?
浏览 2提问于2019-01-28得票数 13
1回答
我已经开发了一个使用Node和Express的REST服务。我已经集成Swagger来定义api文档。关于登录服务，这是我使用的swagger定义：
/**
* @swagger
* /api/v1.0/login:
* post:
* tags:
* - Login
* description: Login into system
* produces:
* - application/json
* parameters:
* - username: User
* description: The use
浏览 0提问于2018-11-01得票数 0
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
实时音视频
云直播活动推荐
腾讯云开发者
