ETman Dec 11 2016 at 21:22

Настройка Swashbuckle (Swagger) для WebAPI

9 min

57K

Website development*.NET*Designing and refactoring*

Comments 11

osharper Dec 12 2016 at 10:09

хорошая штука, жаль, что для .net core версии нет, по крайней мере пока

kotov_a Dec 12 2016 at 11:50

В статусе беты есть. Работает, мы у себя используем.

osharper Dec 12 2016 at 21:30

ура, спасибо!

простите, случайно тыкнул на минус вместо плюса, как отменить?

kotov_a Dec 12 2016 at 22:42

ничего страшного:)

Cromathaar Dec 13 2016 at 00:20

Восстановил баланс :)

SomeOneThere Dec 12 2016 at 14:18

Нашли ли вы способ документировать полиморфные request/response модели?

ETman Dec 12 2016 at 14:21

Что конкретно имеется ввиду поясните, пожалуйста?

SomeOneThere Dec 13 2016 at 05:35

Имеется ввиду, что у нас следующая иерархия:

class Animal
{
  public AnimalType Type {get;set;}
}
class Cat : Animal
{
  public int SpecificCatField {get;set;}
}
class Dog : Animal
{
  public int SpecificDogField {get;set;}
}

В swagger'е необходимо описать, что в случае значения поля Type равным AnimalType.Cat модель должна содержать поле SpecificCadField, иначе SpecificDogField.
На сколько я знаю, стандартный UI не поддерживает такое. Swashbukle генерит документацию только по полям, содержащимся в конечном типе. Не смотря на это, в самой спецификации есть наличие поддержики полиморфизма.

dlevkov Dec 12 2016 at 20:54

С OData на работает, пичалька

ETman Dec 12 2016 at 20:55

Посмотрите на это? https://github.com/rbeauchamp/Swashbuckle.OData
Сам только собираюсь глянуть.

Cromathaar Dec 13 2016 at 00:22

Если еще допишете раздел про версионность API, то вообще замечательная статья будет. Насколько я помню, поддержка версионности там довольно заковыристо сделана.