正如Scott Hanselman在此处的//Build会议上所演示的那样,我正在尝试使用Swagger Swashuckle设置Api应用程序(Azure):http://channel9.msdn.com/Events/Build/2015/2-628.
我已经安装了(使用NuGet)Swagger软件包。Api和Swashback。果心它并没有添加任何控制器或设置,我希望有一个招摇过市的页面。当我导航到{baseUrl}\swagger时,我得到一个404错误。
我认为,由于它有一个UI,除了Api应用程序之外,还需要一个Web应用程序,但我重新观看了演示,Scott明确表示,你可以在任何Api应用程序中添加Swagger-Swashback。在第二个应用程序中,我认为Api发现可能存在问题。有人成功设置了吗?
您做了所有正确的步骤,但不幸的是,对于ASP. NET 5,Swashuckle还不起作用。
你可以找到我!这是具有ASP的Swashback的下一个版本。NET v6支持。这应该能让一切顺利。
这个答案现在已经过时了。见另一个答案。
有一篇很好的博客文章描述了您的问题:https://alexanderzeitler.com/articles/Deploying-a-ASP-NET-MVC-6-API-as-Azure-API-App-in-Azure-App-Services/
这描述了如何添加Ahoy!打包到ASP。NET v6 Web Api项目,并将其作为Api应用程序添加到Azure。
以下是另一个来源:http://devmeetsbi.ghost.io/help-and-test-page-for-asp-net-web-api-asp-net-5-and-mvc-6/
时间一天天过去,现在Swashbuckle适用于vNext(beta8适用于我,可能还有其他版本)-感谢团队和贡献者!
在project.json添加包:
"Swashbuckle": "6.0.0-*",
正在启动中。ConfigureServices()中的cs:
services.AddSwaggerGen();
services.ConfigureSwaggerDocument(options =>
{
options.SingleApiVersion(new Info
{
Version = "v1",
Title = "My Super API",
Description = "A Super API using Swagger and Swashbuckle",
TermsOfService = ""
});
});
services.ConfigureSwaggerSchema(options =>{
options.DescribeAllEnumsAsStrings = true;
});
在startup.cs配置()中:
app.UseSwaggerGen();
app.UseSwaggerUi();
现在,您可以访问API文档-http://domain:port/swagger/ui/index.html
访问您的招摇过市定义-http://domain:port/swagger/v1/swagger.json
然后假设您至少有一个面向dev/uat/staging/prod环境的Internet,获取定义URL然后执行文件-
如果你也很喜欢(https://github.com/swagger-api/swagger-codegen),你也可以设置你自己的代码生成服务器,但是我利用了现有的在线生成器。至少在我使用EF7完全定义模型的情况下,在线编辑器也有完整的模型和关系定义(我知道,尼克...但它比
完整示例项目位于https://github.com/mrsheepuk/ASPNETSelfCreatedTokenAuthExample/tree/beta8
大UPS先生SheepUK
HTH公司
有没有人用spring-data-rest配置了swagger。我知道swagger有DocumentationConfig类,它扫描所有spring-mvc请求映射。但是,如何将其用于spring-data-rest,因为没有定义显式的请求映射。非常感谢在这方面的任何帮助。此外,我还想知道,是否有其他支持Spring-Data-REST的文档框架。
我有一个java项目(tomcat webapp)和一些REST Api。我想为他们生成大摇大摆的文档。我从本教程(github)开始。我没有maven我们使用蚂蚁任务。我加入了swagger-annotations-1.5.0。jar和所有随swagger jaxrs jar 1.5.0版本附带的jar(如果有用的话,我可以包括一个完整的列表),我已经注释了一些方法,我有一个如下的配置类: }
我想从spring boot 2中切换到Micronaut框架。而我也在为那些大摇大摆的场景而挣扎。 在spring boot 2项目中,我有以下依赖项: 和swaggreconfig.class: 它可以很好地启动swagger-ui和spring boot 2应用程序。 我应该向maven添加哪些依赖项,我应该创建哪些类来为Micronaut项目获得相同的结果?
我们在我们的泽西应用程序中使用了@Role允许注释来限制用户对应用编程接口某些部分的访问。我们如何在SwaggerUI中显示这些信息? 到目前为止,我已经用@ApiOperation注释了方法以显示in/out参数,并尝试使用@Authorization/@AuthorizationScope,但我只为我们不使用的oauth2显示了它。最接近out case的是ApiKeyAuthDefiniti
理想情况下,我们将有一个显示所有标记为public的控制器/方法的大摇大摆的页面,以及另一个显示所有endpoint的密码安全endpoint。这可能吗?
我想大摇大摆地发布一个json正文,就像这样: 目前,我有这样的定义: 但是数据是在URL中发送的。这里是Swagger提供的生成的curl: 我知道<code>查询</code>关键字不好,但我没有找到POST JSON正文的方法。我尝试了<code>formData</code>,但没有成功。