Что обязательно должно быть в спецификации REST API?

Качественный контракт REST API (например, в Swagger) должен содержать:

1. Метод и URL: POST /v1/users
2. Описание: Кратко, что делает метод.
3. Параметры запроса: Path, Query, Header параметры (с указанием обязательности и типов).
4. Тело запроса (Request Body): Структура JSON, типы данных, ограничения (например, maxLength: 50).
5. Ответы (Responses): Примеры успешного ответа (200 OK) и всех возможных ошибок (400, 401, 403, 404, 500).
6. Авторизация: Требуется ли токен (Bearer) для вызова метода.