Swagger UI Anzeige zusätzlicher Parameter mit ServiceStack

Question

Ich habe Probleme mit der Anzeige der richtigen Notizen in Swagger mit ServiceStack.

Aufgrund dieser Struktur:

[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 
     } 
    } 

Es produziert:

würde ich die Parameter Liste erwartet nur WidgetId haben, aber es ist WidgetId und UpdageReqWidget anzeigt, die Klassennamen für die Anforderung. irgendwelche Ideen, was ich falsch mache?

EDIT: Ich verwende Versionen 3.9.55 für ServiceStack und ServiceStack.API.Swagger. Ich habe die Vorlagen geändert, um unseren Anforderungen besser gerecht zu werden.

Answer 1

Es gibt eine recent addition to ServiceStack.Api.Swagger, um automatisch einen Anfragetext in der Swagger UI zu generieren. Ich denke, dass es einen Randfall gibt, in dem der Anforderungs-DTO keine Eigenschaften hat, die nicht als Pfad- oder Abfrageparameter angegeben sind, da der Code in diesem Fall immer noch den UpdateReqWidget Anforderungs-Body-Parameter generiert, aber ein leeres Objekt ist Stolzieren.