Swagger UI使用ServiceStack显示额外参数

Question

我在使用ServiceStack在swagger中显示正确的音符时遇到问题.

鉴于这种结构:

    [Route("/Widget/{WidgetId}", Summary = "Updates a widget by id", Verbs = "POST",
    Notes = "Updates a widget by id.")]
    public class UpdateReqWidget : IReturnVoid
    {
        [ApiMember(Name = "WidgetId", Description = "The id of widget to delete.")]
        public int WidgetId { get; set; }
    }

    public class WidgetService 
    {
        public void Put(UpdateReqWidget req)
        {
             //do code here
        }
    }

它正在生产:

我希望参数列表只有WidgetId,但它显示的是WidgetId和UpdageReqWidget,它是请求的类名.什么想法我做错了什么？

编辑:我正在使用版本3.9.55 ServiceStack和ServiceStack.API.Swagger.我已经更改了模板以更好地满足我们的需求.

Answer 1

有一个最近除了ServiceStack.Api.Swagger自动生成的UI扬鞭的请求体参数.我认为有一个边缘情况,请求DTO没有未指定为路径或查询参数的属性,如此处的情况,代码仍将生成该UpdateReqWidget请求体参数,但它将是Swagger中的空对象.