swagger-2.0

9Ciepło

1Odpowiedz

Dodać element przechwytywania modelu schematu na żądanie pola tablicy

Robię adapter dla interfejsu API REST. Użyłem schematu modelu dla ciała metody POST i PUT. @RequestBody Model1 requestBody na adapterze. Teraz napotkałem body z polami wymagającymi tablicy . Swagger U

5Ciepło

1Odpowiedz

Swagger: wsparcie dla opcjonalnych tras

mam trasę z opcjonalnym parametrem: [Route("{categoryId?}")] public HttpResponseMessage Get(int? categoryId=null) Jednak, kiedy nie dają wartość categoryId wezwanie zawiera {categoryId?} w same

57Ciepło

1Odpowiedz

Swagger/OpenAPI - użyj $ ref, aby przekazać zdefiniowany parametr wielokrotnego użytku.

Załóżmy, że mam parametr taki jak limit. To jeden przyzwyczaja się wszędzie i jest to ból musiał zmienić go wszędzie, jeśli trzeba go aktualizować: parameters: - name: limit in: query

8Ciepło

3Odpowiedz

Jak dokumentować punkty końcowe OData (swagger, swashbuckle, other)?

Jaki jest najlepszy sposób dokumentowania punktów końcowych OData? Czy istnieje sposób na wykorzystanie Swashbuckle dla niego?

16Ciepło

3Odpowiedz

Jak wysłać nagłówek autoryzacji z prośbą w interfejsie użytkownika Swagger?

Mam aplikację ASP.NET Web Api 2. Dodałem do niego SwashBuckle (Swagger dla .NET). Wyświetla moje punkty końcowe bez problemu, ale aby wysłać żądanie, muszę dołączyć nagłówek autoryzacji do tego żądani