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

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