💚 Swagger: 3-я и главная часть практического руководства для освоения инструмента 💚


В этой части практического руководства:

1️⃣ Создаем новую версию API-документации, чтобы не потерять результаты предыдущих наработок.

2️⃣ Описываем метод POST с примерами тела запроса и ответа по заданию. Пример ответа содержит несколько кодов (HTTP-201 и -403). Ответ с ошибкой 403 также имеет свою структуру тела (body) в JSON.

3️⃣ Описываем метод GET с примерами запроса и ответа.

4️⃣ Публикуем результаты. Делимся с коллегами аналитиками и разработчиками своими успехами - ссылкой на свой проект!


Каждый шаг в руководстве подробно описан. Все части кода подробно описаны, чтобы вам было легко разобраться. Есть ссылка на образец документации, который ожидается получить в результате вашей самостоятельной практики.

Более глубокое погружение в дизайн REST API будет в течение всего января 🗓


Если в процессе работы по инструкции возникнут вопросы или что-то не получится, обязательно задавайте вопросы в комментариях - поможем!


У кого всё получилось - ставьте 💚!