Comments 11
хорошая штука, жаль, что для .net core версии нет, по крайней мере пока
Нашли ли вы способ документировать полиморфные request/response модели?
Что конкретно имеется ввиду поясните, пожалуйста?
Имеется ввиду, что у нас следующая иерархия:
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 генерит документацию только по полям, содержащимся в конечном типе. Не смотря на это, в самой спецификации есть наличие поддержики полиморфизма.
С OData на работает, пичалька
Если еще допишете раздел про версионность API, то вообще замечательная статья будет. Насколько я помню, поддержка версионности там довольно заковыристо сделана.
Sign up to leave a comment.
Настройка Swashbuckle (Swagger) для WebAPI