169 похожих чатов

Вопрос. Для openapi (бывший swagger) - что лучше, использовать open_api_spec

библиотеку или писать yaml фаил руками? Какой опыт?

7 ответов

4 просмотра

open_api_spex неплох, если сервер определяет апи

Dmitry-A.R. Автор вопроса
Lama Lover
open_api_spex неплох, если сервер определяет апи

Мне кажется, что yaml быстрее написать руками и понятнее и задокументировано всё лучше - и проще потом изменять кому-то другому.

Dmitry-A.R. Автор вопроса
Lama Lover
open_api_spex неплох, если сервер определяет апи

Я начал копаться в open_api_spec - и куча вопросов, что в каком случае как что писать….А документация там относительно минимальная 🙂

Dmitry A.R.
Я начал копаться в open_api_spec - и куча вопросов...

Ну, там банальный open api 3 везде. Надо смотреть проекты-примеры. Альтернатив open_api_spex нет. Точнее, есть phoenix_swagger, но он очень душный

Dmitry-A.R. Автор вопроса
Lama Lover
Ну, там банальный open api 3 везде. Надо смотреть ...

Альтернатива написать yaml руками - про неё и вопрос.

Dmitry A.R.
Альтернатива написать yaml руками - про неё и вопр...

Я всегда думал что OpenAPI пишется в JSON-е Писать руками его будет душно, если честно

Dmitry A.R.
Я начал копаться в open_api_spec - и куча вопросов...

в выходные занимался тем же самым, что и ты. вроде всё получилось, но API пока очень минимальное, потом будет расширяться. да, тут оно определяется сервером. наоборот я видел, как делают гошники, не очень сильно впечатлён. в эликсире тоже генерят из спеки?

Похожие вопросы

Обсуждают сегодня

Hi there everyone Is there anyone who have not started hamster bot yet? I need only one, I'll be glad if you do this for me DM if you haven't yet
Mehrshad
53
why some site like google has separate page for username/email and password?
Mr Thieves
21
Может быть небольшое отступление, но я тут решил обратить внимание на то, сколько весит хелловорлд на с++... Зачем он весит почти 250 Кб? У меня оконное приложение на фасме ве...
The Bird of Hermes
14
всем привет! у кого есть опыт подписания и нотаризации electron приложений для macos? такая проблема: использовал @electron/osx-sign и notaritool. процесс подписания и нотараз...
Артем Клементьев
6
А как старый хаскел с новым стыковать ? потому как тут работает https://play.haskell.org/saved/C3xpMzcd, а вот тут https://stepik.org/lesson/7602/step/9?unit=1473 нет ошибка C...
Fedor
131
@Dreamer_0x01 @helgispbru @Ambrion Разговор шёл об уязвимости. Меня беспокоит именно она. Все прочие вопросы, а равно и жизненная мудрость - пока в сторону :) Так вот сам ...
Андрей [aharito] Харитонов
5
What do you wanna learn?
Malware ( DM = BLOCK )
12
Подскажите, сейчас что то есть (JS модуль какой-нибудь), что можно использовать для: 1) переваривания javascript codа из html fileа, т.е. разбивки, на переменные, команды, бло...
Iar De
32
Всем привет. Программно добавляю документы в таблицу site_content в конце очищаю кеш $modx->clearCache(); Но документы появляются в дереве только после того как редактирую ...
Владимир
8
Мне интересно, скорее людей здесь используют D, Rust, C/C++ для решения реальных прикладных задач за деньги?)
Evil Satanson
43
Карта сайта