Duplikate api's aufgelistet durch die Hilfeseite

Question

Ich benutze das Webapi Hilfeseiten nugget Paket von Microsoft.

Als ich vor kurzem einen neuen Controller hinzugefügt, alle meine Routen in der Hilfeseite erscheinen zweimal:

GET api/v2/something/{id} 

und

GET api/v2/something?id={id} 

Wie kann ich diese Duplikate entfernen?

Überraschenderweise für einige ältere Controller, die ich letztes Jahr hinzugefügt habe, ist das nicht passiert.

Der einzige Unterschied, den ich mir vorstellen kann, ist, dass ich in der neuen Steuerung dynamic als Antworttyp verwendet habe, aber ich habe auch die ResponseTypeAttribute so in der Hilfeseite die DTO-Modelle korrekt angezeigt.

Answer 1

Ich empfehle Ihnen Swagger/Swashbuckle anstelle der WebAPI Hilfeseiten. Sie können es über nuget installieren. Es wird ein SwaggerConfig.cs im App_Start-Ordner erstellen. Es könnte einige kleinere Verbesserungen geben, die Sie abhängig von Ihren Anforderungen machen müssen. Überprüfen Sie einfach die Dokumentation.