DT
нужен под мак
Size: a a a
2021 June 08
DT
pre-bundled openapi в платных продуктах JetBrains работает норм, но он доступен только в платных. В бесплатных (и по отдельной подписке) та же проблема - работа только с одним файлом
i
может купить будет дешевле чем тратить время на поиски и допиливание бесплатного аналога?
DT
100% но я кое как уговорил не в вики разрабатывать контракт а в опенапи формате. И щас начинается "ой то не работает, ой это не пашет, платить надо?!. Че за херню ты посоветовал?"
SP
А народу сколько?
DT
пока 2-3 человека, хоть как-нибудь уж начать
SP
Spotlight попробуй, там до 3-х бесплатно
SP
Из тех что тыкал более менее достойно выглядит
SP
API Design & Documentation Management | Designing & Building OpenAPIs
https://stoplight.io/
https://stoplight.io/
DT
спасибо, поковыряю
ЗД
Мы пробовали. Для ручного документирования OpenAPI это лучший инструмент.
i
еще как вариант использовать постман. Для особых извращений. Используется для отладки и тестов АПИ, заодно может генерировать апишку.
SP
проще постман коллекции генерить из openapi :)
SP
ну вот сравни с spotlight.
В
Вообще, openapi можно генерить из аннотаций, и рендерить его вместе с клиентом прямо в гитлабе
В
гитлаб умеет
DT
это не похоже на contract-first
SP
но если ты хочешь договариваться о контрактах до реализации то нельзя
В
да, согласен