Swagger/OpenAPI Specification как основа для ваших приёмочных тестов

[Pilat]

Это произошло в связи с независимым развитием Swagger Codegen 3.X и Swagger Codegen 2.X. Из-за этого нарушилась обратная совместимость. Очень много клиентов исчезли и не были поддержаны.

Вот после этого я жутко в REST разочаровался. Сам по себе он простой, но без проверок казалось что пользоваться невозможно. Версия 2 поддерживалась всем что мне нужно, всё работало, кодогенераторы работали и я сам их дописал… и вдруг SmartBear решил запустить версию 3, а версию 2 просто похерить, например их компонент в Eclipse вдруг перестал работать с моими файлами — им просто захотелось и всё. Такая компания. И что им придёт в голову в следующий раз непонятно.

Ну и REST с OpenAPI превратился в недо-SOAP. Со всеми его минусами и почти без плюсов, причём всё завязано на одну несколько стрёмную фирму.

[Pilat]

Сам по себе REST интереса не представляет в силу неконкретности термина, а вот вместе с OpenAPI/Seagger становится интересным. Об этом статья и говорит. И не мешает всё-таки учитывать контекст, в котором сделан мой комментарий.

[VolCh]

Я бы сказал, что 99% разработчиков под REST подразумевают вообще не то. И это надо учитывать в общении с ними, даже если ты относишься к 1%