swashbuckle

    0热度

    1回答

    生成swagger.json文件不包括我有重写方法XML内部注释。对于所有其他方法,内联注释都包含在生成的swagger.json中。 xml文件包含所有注释,以便文件看起来是正确的。所有的路线都按照他们应有的方式工作。 为什么不包含在生成的swagger.json所有XML注释? PetsApi.cs public abstract class PetsApiController :

    2热度

    2回答

    在ASP.NET Web应用程序的核心使用Swashbuckle.AspNetCore,我们有响应类型,如: public class DateRange { [JsonConverter(typeof(IsoDateConverter))] public DateTime StartDate {get; set;} [JsonConverter(typeof(I

    0热度

    1回答

    我有一个asp.net core 2.0 api控制器动作,带有一个可选(和可为空)参数。 Swashbuckle.AspNetCore 1.0.0当方法签名中存在此参数时,生成Swagger文档失败,但如果将其从签名中删除,则会成功。它出现的可选参数是错误的原因,但我不知道为什么...... 我使用与ASPNET-API的版本Swashbuckle整合: https://github.com/M

    1热度

    1回答

    我用下面的代码到一个自定义标题添加到操作: public class RequestIdParameter : IOperationFilter { public void Apply(Swashbuckle.Swagger.Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription

    2热度

    1回答

    我有一个ASP.NET Core 2.0 Web API,我通过Swashbuckle添加了Swagger。这很好。 我还在ASP.NET Core中启用了app.UseDeveloperExceptionPage()选项。这很好。 但他们一起玩得不好。因为SwaggerUI只是将返回的HTML显示为文本。 对于GET请求,它不是一个大问题,因为我只是将url粘贴到浏览器中。但对于POST不起作用

    3热度

    1回答

    我们正在使用Swashbuckle来记录我们的WebAPI项目(使用Owin)并试图修改Swashbuckle生成的Swagger文件。 随着DescribeAllEnumsAsStrings()和枚举属性类似下面,我们得到预期的结果: class MyResponseClass { public Color color; } enum Color { LightBlue

    1热度

    1回答

    [HttpGet] [Route("students")] [SwaggerOperation(Tags = new[] { "Student" })] [SwaggerResponse(HttpStatusCode.OK, Type = typeof(ResponseModel<IList<Student>>))] [SwaggerResponseExample(HttpStatusCo

    1热度

    1回答

    我有一个端点需要一个自定义类型(在这种情况下是一个NodaTime.LocalDate)。该类型具有自定义模型联编程序,并使用MapType<>映射到Swagger中。 当路径中使用类型作为路径参数时,端点不会显示在Swagger/Swashbuckle中。但是,如果我将其删除(以便将其作为URL参数包含在内),则它显示得很好。 一个简单的版本端点: public class MyControll

    0热度

    1回答

    在下面的代码,你会看到在ProducesResponseType一件T型(通用),但我不能让它工作,因为它不是一个特定类型: public class ApiController<T> : ApiBaseController where T : class, IDocument { protected IDataService<T> data = null; [H

    0热度

    1回答

    Swashbuckle在提取C#XML注释以制作Swagger API文档方面做得非常出色。 Swagger支持记录查询字符串参数。但是如果有一种方法可以在XML中记录查询字符串参数,所以Swashbuckle会导出它们,我还没有找到它。 我有类似: /// <summary> /// List all users /// </summary> /// <param