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

[osharper]

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

[kotov_a]

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

[osharper]

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

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

[kotov_a]

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

[Cromathaar]

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

[SomeOneThere]

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

[ETman]

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

[SomeOneThere]

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

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]

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

[ETman]

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

[Cromathaar]

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