Современная архитектура веб-приложений. Эти ваши микросервисы. Часть 3

Для успешного взаимодействия сервисов друг с другом важно, чтобы команды, которые их делают, имели прозрачную коммуникацию. Они пишут документацию (спецификации, спеки, доки, FS, эфэски), которой могут воспользоваться в другой команде для понимания как работать с конкретным сервисом.

А ещё (в идеальном мире) они качественно описывают взаимодействие со своим API. Делается это с помощью специальных комментариев в исходном коде сервиса, которые потом хитрым образом обрабатываются сторонним ПО и выдают удобную страничку, на которой есть вся информация: какой тип запроса отправлять, куда, чего слать, что получишь в ответ (см. подробнее, например, swagger).

По этой же страничке ты можешь оценить объём своей будущей работы (если ты тестировщик бэкэнда конечно же) или подёргать ручки сервиса в реальном времени.