proper api document example

Example 1: what to consider when writing api document

Source of the content
Document plan or sketch
Delivery layout
Information needed for every function in the document
Automatic document creation programs

Example 2: api documentation

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