Клуб технических писателей

OpenAPI

Konstantin Savenkov
3 августа, 07:58

Привет. 

Так получилось, что мы (https://inten.to) занимаемся интеграцией большого количества API. Это удобно, когда у API есть понятная и структурированная документация. За последние год-полтора довольно много компаний переходят на OpenAPI (в прошлом Swagger, https://www.openapis.org), вокруг которого собрался неплохой консорцим (https://www.openapis.org/membership/members). Мы там, наверное, единственная из условно российских компаний. 

К сожалению, в России стандарт распространен довольно слабо.

Мы можем на каком-нибудь из митапов/конференций (например, Гипербатон) рассказать про OpenAPI - как появился, зачем, какие вокруг стандарта есть инструментальные средства, куда это все двигается итп.

Интересно?

4 комментария
Подписаться на комментарии к посту
Интересно, конечно. А особенно интересно почему именно swagger?)
Konstantin Savenkov
3 августа, 18:49
Abramenko Egor,
он достаточно удобен, а сейчас все эти ребята  https://www.openapis.org/membership/members делают его еще удобнее (на днях вышел новый стандарт). 
Konstantin Savenkov,
я сталкивался с проблемой, когда документация, написанная в swagger в одном сервисе, не хотела отображаться в другом. Ругалась какими-то ошибками и приходилось переделывать. Хорошо, если такие проблемы редкость.
kuzin-aleksey-19
4 августа, 11:39
Присоединяюсь. Было бы интересно послушать :-)