ну вот и разделять на простой или сложный смысла мало ) Еще разделите RESTful и RESTlike реализации "в октябре" 😄
У меня в статье так и написано )))) И да, мы сегодня сделаем endpoint и собственно сам API или REST API или RESTful API… да господи, всем насрать, давайте делать.
Мы на октябре от классического RESTlike, до graphql реализаций делаем 🙂 Часто используем октябрь как бекенд, не менее часто выключаем cms модуль из-за отсутсвия необходимости в нем )))
автодокументация вот еще актуальная задача у меня для октября
для стандартных json (hal, array), любой пакет с парсером @SW, @SWO аннотаций, натравливаем на каталог плагинов, а лучше свое пространство и будет доку генерировать нормально
еще был опыт с натравливанием через npm генератора доки, но почему-то не зашел. Видимо из-за необходимости еще ноду подтягивать. Потому стандартных команд достаточно обычно.