Postman ― отличный инструмент. Если ты работаешь с API, скорее всего, хотя бы раз его использовал. Я перестал пользоваться аналогами когда первый раз попробовал собрать через него документацию: для каждого запроса можно указать md-разметку с описанием параметров, после чего в пару кликов - опубликовать на хосте и поделиться ссылкой.
Пару проектов назад меня бросили на жуткий legacy: отсутствие документации и тех, кто когда-то это писал, заставили долго и упорно заносить все запросы в Postman, по мере их нахождения в проекте, описывать документацию и структурировать по папкам.
Сегодня нашёл отличный инструмент для Laravel ― генератор коллекции по уже существующим роутам. Знал бы о нём тогда ― сэкономил бы много времени :) Ставим как пакет, запускаем одной artisan-командой ― готово, коллекция в формате json ждёт импорта. Пользуйтесь!
https://github.com/profclems/postman-collection-generator
Post #149
1.73K