Проектирование API в терминах RESTful

Когда мы работаем с микросервисной архитектурой, часто возникает необходимость описать коммуникацию двух сервисов. Но как это сделать правильно, чтобы API выглядело понятно для потребителей, было простым в расширении и поддержке?