This is a collection of example apis based on the OpenApi 3.0 specification which can be run on the local server and tested with the help of Postman as described below.
Ecommerce api
Hotel booking api
Library management api
Social media api
Swagger 2.0 Petstore api
Swagger 3.0 Petstore api
Download and install python (3.6+) here
You can either download the files from Github as a zip or clone the repo to your local machine using -
git clone https://github.com/FireTail-io/python-openapi-quickstarts.git
-
You can download and use postman or use the web version in which case you have to download the postman desktop agent to be able to send api requests to your local host.
Download and install postman here -
Open the postman client and import the postman imports by clicking on File -> import
-
Click on folder, choose "postman_import" folder in the example of your choice and click open
-
Click import with the selected files and environment
Install the required libraries using the following command in the cli in the downloaded location.
python3 -m pip install -r requirements.txt
Run the file main.py or use the following command to start the local server (It runs on http://127.0.0.1:8080)
python3 main.py
NOTE: Call the endpoint called 'RETURN JWT TOKEN' to generate and set an authorization token which will allow access to the other endpoints. If the token expires, simply call the endpoint again.
Once you have the local server running, you can now send requests via postman.
- Click on collection on the left and then select the request that you would like to send. Then fill in the parameters and body as required.
- Click send and the response will be displayed as shown.
