На пути к публичному API выясни, кому оно нужно. Публичное API затратно: проверка безопасности, тестирование на обратную совместимость, поддержание обратной совместимости, разработка примеров, разработка документации, проведение семинаров, разработка семинаров, генерация API reference, создание сайта. Если заказчик платит только за интеграции с выбранными партнерами, то все эти затраты излишни. Если заказчик думает только в терминах краткосрочной окупаемости, то публичное API ему не нужно. Выдав партнеру аннотацию swagger/raml, ты достигаешь 80/20 эффекта и пусть партнер ругает, но пишет. Разработчики с обеих сторон недовольны, каждый апдейт лишь увеличивает технический долг, но деньги от интеграций идут и KPI соблюдаются. Так к чему перфекционизм? Отринь его, смирись и понимай, что цель бизнеса в получении прибыли, а не создании более прекрасного мира.