Swagger.

[sorhed]

Прорекламирую Swagger. Это такая штука, которая позволяет на коленке специфицировать всякие там REST/JSON API.

Да, оно сырое, необтёсанное, и не во всех языках программирования есть адекватная поддержка. Но альтернативы я не знаю. Жизненно необходимая штука, коей будут вскоре пользоваться все.

Comments

[lelia_br]

прикольно, у меня на работе только что им воспользовались - отличная штука!

[ext_2671195]

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

[sorhed]

А какой нужен, по-вашему?

[ext_2671195]

WSDL и сериализация в SOAP сообщения. Всё уже есть лет 15 и встроено в JVM включая поддержку ассинхронных вызовов. Ни одной библиотеки не нужно чтобы написать клиент и сервер. Работает как часы и не надо голову ломать где у нас get а где post, всё самодокументированно. Если надо генерятся стабы для любого языка включая java-script

[sorhed]

Вопросов больше не имею, умываю руки.

[sorhed]

Юнион-типов действительно нет. Пользуйте discriminator.

(И я вполне понимаю афтаров -- поддерживать весь нынешний зоопарк языков в состоянии, где даже в скале ещё толком нет union types, совершенно нереально.)

[vicont]

Основных альтернатив две - RAML и API Blueprint. Год юзаем в большом боевом проекте RAML - тоже всё небезоблачно, но гораздо лучше, чем ничего. Запилили sbt-плагин, который генерирует routes для Play Framework из raml-описания.

[ext_2671195]

Не прошло и 20 лет как появился кривой аналог WSDL-а в для json-а и реста.
Щас набегут хипстеры и скажут что автоматизация это не модно и не молодёжно, а настоящие пацаны парсят запросы/ответы/эксепшионы вручную.

[anonim_legion]

Это не хипстеры. Это подневольные трудящиеся, вынужденные делать "быстро и грязно", потому что им начальник приказал, потому что у начальника заказчик заказал. А поскольку у этих людей мало денег, они не могут сказать начальнику "пошел вон со своей идиотской работой" или заказчику "иди, дядя, других исполнителей ищи для ерунды твоей".

[c0s]

а что насчёт restconf/yang в сравнении со swagger'ом?
restconf/yang как способ документируемого моделирования с restful- и rpc-операциями - весьма сильная вещь. нам только тулов не хватает: либо не нравятся, либо не работают.

[sorhed]

Да подобных вещей много, но Swagger/OpenAPI, похоже, всех победил.