What is OpenAPI?
OpenAPI is an API Specification or an API description format for REST. Using 1 simply structured file you can describe your entire API which includes endpoints, possible operations (HTTP methods) over the endpoints, request parameters (input and output) and more. It supports 2 formats: YAML or JSON. The format is very simple to read and easy to learn for both humans and machines.
Now, what Is Swagger?
According to the documentation, Swagger is a set of tools that can help you to create the OpenAPI Specification document and even consume REST APIs or basically test your API.
Why would you use OpenAPI at all?
The main reason is for documenting your API, does not matter before it was developed or after. Every API needs a documentation and OpenAPI is a good standard for describing API. By simply pasting OpenAPI specification into Swagger UI will let you create a nicely laid out page with a human readable documentation of your endpoints and what is more important it will allow you to execute remote requests to your API from there.
What is API stubbing or API mocking?
This is a software development technique that lets software engineers remove blockers or dependencies on the web services or APIs that do not exist yet by using fake endpoints with a dummy data. Swagger even allows you to create such API stubs based on the OpenAPI specification. But for this you’ll need to be familiar with one of the supported server side programming languages and technologies. But what if you do not know those ones or you do not know any? That’s where the online API mocking tools come into play and particularly QuickMocker.
What is QuickMocker?
QuickMocker is a brand new API mocking tool that allows you to easily create a dummy API or fake API for whatever purpose you need like development, testing, integration etc. without having knowledge of any server side programming language or technologies. Now if your back-end developers or API 3rd party providers care about you and they use a design first principle while developing their web services, they might simply provide you with the Open API specifications in a JSON format schema and you can import them as API stubs in a few clicks. QuickMocker provides several options while importing the API endpoints. You might want to read more about this in the following article: Import API endpoints from OpenAPI or Swagger Specifications.
So, try to become a “mocker” by creating a free account inside QuickMocker online tool and begin to mock API.