The Gorest API Automation project is an api testing framework that ensures the reliability and security of gorest APIs through a range of features. Gorest APIs are freely available APIs with Bearer access token and tons of features. The framework incorporates data-driven testing, positive/negative tests validation, and Pytest parameterizations for efficient test of multiple data. With logging and detailed reporting, it provides insights into test results. The project includes a retry mechanism for handling limited request failures and validates various aspects such as authentication,content-type, response time, pagination parameters, status codes, response structure, and response validation. Custom assertions enhance test coverage, making it a comprehensive framework for thorough API testing.

• Docker containers makes it easy to run the tests in a specific environment where you do not have to install anything specifically. Just pull the image and run simple command to run the tests.
• Image to use for this project gorestapi-automation
• All the instructions are given on docker image overview for running tests in container

• Signup to go rest for the access token https://gorest.co.in/
• store the access token in conf.ini file in token variable
• Access token is required for POST, PUT, PATCH and DELETE methods.
• Created data with a particular access token will only be available for same user and not to the rest.
• According to gorest we can access the GET request without Bearer token but the data created during tests won't be available to validate, Hence used Bearer token for GET requests also.
• Data will be removed on daily basis.
• Do check the website https://gorest.co.in for more details on request-rate-limits pagination parameters status codes curl example for REST API

• Clone the Project

git clone https://github.com/MubeenAhmadShaikh/GorestAPIAutomation.git

• Go to the project directory

cd GorestAPIAutomation

• Install dependencies

pip install -r requirements.txt

• Create conf.ini file using conf.ini.templates file in root directory and edit the token variable

token = your_access_token_here

• Navigate to tests directory

cd tests

• Run all the tests

pytest -s -v

Dependensies pytest-html

• Run the tests using following command

pytest test_filename.py -s -v -m "marker_name" --html=path_to_save_report/report.html

Generated Pytest HTML report.

Dependensies allure-pytest allure commandline

• Run the tests using following command

pytest test_filename.py -s -v -m "marker_name" --alluredir=path_to_directory_for_saving_json_data

• Using the JSON data generated for tests generate allure reports with following command

allure serve path_to_directory_of_json_data

• To save the html to system use following command

allure generate path_to_directory_of_json_data

• Video of allure interactive reports

• GET, POST, PUT, PATCH, DELETE APIs Tested
• API Test Automation
• RESTapis Testing
• Schema Validation
• Response data Validation
• Data driven tests
• End-to-end tests
• Positive/negative tests
• Pytest Parameterizations
• Logging
• Interactive reporting [ HTML Reporting | Allure Reporting ]
• Retry mechanisam for limited requests
• Auth validations using Bearer token
• status code validation
• Searching | Pagination validation
• content-type | environment | response time validations
• Auth token verification
• Response body validation
• Custom assertions

• Python
• Pytest
• Requests library
• Allure reports
• Docker

Python Pytest Allure reports Docker HTML reports Automation Testing API Testing RESTapi