к базе знанийстатья

Специфицируй это. Доклад Яндекса

читать на Хабре

Доклад о том, что собой представляет спецификация REST API на примере OpenAPI + Swagger и зачем нужна такая связка.