cancel
Showing results for 
Search instead for 
Did you mean: 

Internal API endpoints usage documentation in Microservices

Danielgu
Occasional Visitor

Internal API endpoints usage documentation in Microservices

I am doing some research about API documentation for microservice which I would like to implementing in our product.
For now I saw tools like Swagger which are automating API documentation but only for endpoints (url, objects, params, responses..), but I couldn't find features to document the usage of these APIs, for example which other internal components are using these endpoints (UI/other microservices).
I thought this could be good information to document, for purposes like editing existing APIs and be aware of other components which relays on the changed API.
Maybe I am mistaken and this feature is unnecessary and there are other solution and best practices to avoid breaking other services/UI which are using an API which is going to be edited (params/responses). 
​Is there feature to achieve this?

Thanks in advance!
New Here?
Join us and watch the welcome video:
Announcements
Top Kudoed Authors