Что такое RAML за 12 минут
Swagger для аналитика: как читать спецификацию API без боли
Ты не пишешь бэкенд, но проект внезапно оказался про интеграцию двух систем, и теперь тебе надо понять, какие «ручки» уже есть, что они принимают и что возвращают. Я это знаю не понаслышке: требования сами себя не напишут, а спрашивать разработчика каждый раз, «а можно ли тут передать дату», становится неловко уже на пятый вопрос. В такой момент и вспоминаешь, что есть Swagger. И да, это не только «документация для девов». Это то, как устроен интерфейс между сервисами, и разобраться в нём может и должен каждый аналитик...