documented design document with api integration sample 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.