Как вы пишите документацию на ваши REST сервисы? Swagger используете или в postman/fiddler цепочки запросов сохраняете?

Недавно открыл для себя очень простой формат, позволяющий писать интерактивную документацию в файле с расширением .rest или .http. Простой плагин для visual studio code (или для других ide тоже есть) позволит выполнять запросы и просматривать ответы. Всё что надо есть: можно объявлять переменные, описывать простые правила. Мне такой формат очень нравится, далеко не всегда хочется тащить swagger, но интерактивную документацию иметь полезно, а тут вы получаете её почти даром.

Если вдруг вы тоже не слышали, то загляните в описание
https://marketplace.visualstudio.com/items?itemName=humao.rest-client

#rest #api #docs