2016-09-28 4 views
0

Я пытаюсь документировать API с Swagger (в Rails с драгоценным камнем swagger-docs). У меня есть базовая документация. Ran sudo SD_LOG_LEVEL=1 rake swagger:docs RAILS_ENV=production без ошибок.Swagger UI не отображает файлы JSON

Моя проблема заключается в том, что пользовательский интерфейс Swagger не показывает всю мою документацию при навигации по JSON. Я могу просматривать отдельные файлы/контроллеры (то есть users.json), но когда я обращаюсь к api-docs.json, я могу видеть информацию об авторских правах и компаниях и т. Д., Но ни один из моих API.

Каждый контроллер имеет свою документацию, написанную до {root}/public/apis/v1/*.json.

Скриншоты:

api-docs.json shows api description only example json file that exists and that I should see

ответ

1

Может у создавать URL в чванство документы как базовый путь и метод версии и документы/index.html URL линии там могут быть некоторые несоответствия с базового пути упоминается в чванства docs и сгенерированные файлы разворота

+0

base_path: '/'; Swagger исследует URL: 'http: //192.168.33.7: 31000/api/v1/api-docs.json'; Расположение контроллера API в проекте: 'web/app/controllers' –

+0

Дайте базовый путь как« http://192.168.33.7:31000/ » –

+0

Или если у вас есть общий файл конфигурации yml, который можно использовать для всего приложения, вы можете упомянуть, что URL-адрес yml в index.html и базовый путь –

Смежные вопросы