why we should documentation API code example

Example: api documentation

Yes we use swagger for our API documentation and this is 
where the description and guidelines of API endpoints are.