Top Banner
API Documentation Presenter: Naincy Gupta Mindfire Solutions Simple Steps to create RestFul API document
18

RestFul Api documentation with Swagger

Jan 20, 2017

Download

Technology

Naincy Gupta
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: RestFul Api documentation with Swagger

API Documentation

Presenter: Naincy GuptaMindfire Solutions

Simple Steps to create RestFul API document

Page 2: RestFul Api documentation with Swagger

About Me Certifications:M70 101 - Magento Certified DeveloperOCA 870 - MYSQL

Contact Me: Email: [email protected]: mfsi_naincy.gupta

Connect Me: -Facebook : https://www.facebook.com/naincy.gupta.35574LinkedIn : in.linkedin.com/pub/naincy-gupta/66/440/6a3/Google+: https://plus.google.com/u/0/+NaincyGuptaTechSharing/postsBlog: http://[email protected]

Page 3: RestFul Api documentation with Swagger

STEP 1

- Open POSTMAN, and create a collection with any name. Eg. My collection

- Run your API call in POSTMAN.

- Save your API calls in the collection created.

- Go to your collection and download the collection

- Save downloaded collection.

Page 4: RestFul Api documentation with Swagger
Page 5: RestFul Api documentation with Swagger
Page 6: RestFul Api documentation with Swagger
Page 7: RestFul Api documentation with Swagger
Page 8: RestFul Api documentation with Swagger
Page 9: RestFul Api documentation with Swagger

STEP 2

- Open any converter to transform API into another fomat. (https://apitransformer.com/#convert)- Select the format in which you want to convert (Swagger YAML or Swagger JSON)

- Click to Transform your API Collection(Will give you a converted file.)

Page 10: RestFul Api documentation with Swagger
Page 11: RestFul Api documentation with Swagger
Page 12: RestFul Api documentation with Swagger

STEP 3

- Open swagger editor (http://editor.swagger.io/#/)- Import the converted file.

- Its Done! (Your document is ready)

Page 13: RestFul Api documentation with Swagger
Page 14: RestFul Api documentation with Swagger
Page 15: RestFul Api documentation with Swagger
Page 16: RestFul Api documentation with Swagger

Other Benefits

- Once your document ready, you will be able to download client in any format various options are avaialble like HTML, PHP, C#, Ruby, Python, Perl, Java, etc.

Page 17: RestFul Api documentation with Swagger
Page 18: RestFul Api documentation with Swagger

Thank You!