Открытый микрофон #6. Как написать свою первую спецификацию на REST API

Во втором выпуске провели встречу с Марией Яковлевой, ведущим аналитиком Платформы Сфера. В интернете много описаний особенностей архитектурного стиля REST, но мало информации о том, как аналитику начать создавать качественные спецификации на REST методы. Маша рассказала: 🙋‍♀️как начать описывать спецификации на REST API, 🙋‍♀️с какими ошибками может столкнуться аналитик, 🙋‍♀️как избежать ошибок на разных этапах выполнения задачи, 🙋‍♀️какую информацию и для чего необходимо описать в спецификации на REST API. На всякий предупредим, что доклад был не про: 🙅‍♀️ перечисление методов REST API и их отличий, 🙅‍♀️принципы REST, 🙅‍♀️REST и RESTful, 🙅‍♀️обзор инструментов для описания и тестирования API.