Swagger со статической документацией

Я хочу использовать Swagger для документирования моего спокойного интерфейса. Проблема в том, что я не хочу t, чтобы автоматически генерировать мою документацию, аннотируя мой код. По сути, я не хочу связывать мою внутреннюю модель данных с виртуальной моделью данных, предоставляемой интерфейсом. Похоже, я могу просто предоставить серверу файл Resources.json, а затем соответствующий файл JSON для каждого обработчика ресурсов. Однако, когда я попробовал это, я столкнулся с множеством маленьких ошибок, пытаясь определить правильный синтаксис JSON и предоставить правильные поля ответа заголовка HTTP.

Кто-нибудь использовал Swagger таким образом? У кого-нибудь есть документация или примеры? Все, что я мог найти, было сосредоточено на простом использовании клиентских библиотек для создания вещей для вас.

26
задан Lee Jensen 12 May 2012 в 03:33
поделиться