библиотеку или писать yaml фаил руками? Какой опыт?
open_api_spex неплох, если сервер определяет апи
Мне кажется, что yaml быстрее написать руками и понятнее и задокументировано всё лучше - и проще потом изменять кому-то другому.
Я начал копаться в open_api_spec - и куча вопросов, что в каком случае как что писать….А документация там относительно минимальная 🙂
Ну, там банальный open api 3 везде. Надо смотреть проекты-примеры. Альтернатив open_api_spex нет. Точнее, есть phoenix_swagger, но он очень душный
Альтернатива написать yaml руками - про неё и вопрос.
Я всегда думал что OpenAPI пишется в JSON-е Писать руками его будет душно, если честно
в выходные занимался тем же самым, что и ты. вроде всё получилось, но API пока очень минимальное, потом будет расширяться. да, тут оно определяется сервером. наоборот я видел, как делают гошники, не очень сильно впечатлён. в эликсире тоже генерят из спеки?
Обсуждают сегодня