Документация по конечным точкам API в nodejs / expressjs - PullRequest
0 голосов
/ 30 мая 2020

Как можно легко и автоматически сгенерировать документацию по конечным точкам api из модели объекта (например, пользователя)?

Я пробовал swagger-ui- express и swagger-jsdo c: моя проблема с этими двумя в том, что они слишком ручные:

Для любого изменения в модели мне нужно вручную изменить .yaml или. json файл (ы) /definition.

Я ожидал что-то, что работает как coreapi или swagger do c в python / django, где пакет считывает модель или сериализаторы и генерирует документы и параметры конечных точек, необходимые на основе метода HTTP и свойств модели ...! Никакой дополнительной работы: как в swagger-ui- express, где разработчики создают объекты типа json, определяющие модель, которую они уже определили в базе данных (особенно при использовании mon goosejs).

Заранее спасибо!

...