Swagger поможет конечно, но реализация может быть вполне основана на спецификации OpenApi. Тем более такие реализации уже готовы в виде соответствующих библиотек. Более того гиганты (google, ibm, mcrsft) всецело поддерживают данную инициативу, а значит это вполне может стать промышленным стандартом во многих крупных продуктах.