Network API contracts/documentation are just an attempt of type safety over the untyped network boundary.
Network communications are the most tedious and annoying part of programming for me because of the validation of the request body and checking that it has all the fields needed.
Microservices only increase the amount of documentation needed. I would prefer to lessen the amount of documentation by letting the compiler/code do the work instead.