🍔 Stellar Burgers API Automation Framework

---

📌 Project Overview

Automation framework for testing the API of the educational service
Stellar Burgers.

The project demonstrates:

• Clean API test architecture
• Separation of test logic and API clients
• POJO-based request models
• Test data generation using Faker
• Validation of positive and negative scenarios
• Integration with Allure reporting

---

🎯 Test Coverage

👤 User API

POST /api/auth/register

✔ Successful user registration
✔ Duplicate user registration validation
✔ Required fields validation (missing email, password, or name)

POST /api/auth/login

✔ Successful login with existing user
✔ Login with incorrect password
✔ Login with incorrect email

---

🍔 Orders API

POST /api/orders

✔ Create order with authorization
✔ Create order without authorization
✔ Create order with ingredients
✔ Create order without ingredients
✔ Create order with invalid ingredient hash

---

🏗 Architecture

The project follows a layered structure:

src
├── main
│ ├── client → API Clients (UserClient, OrderClient)
│ ├── models → Request body POJOs
│ └── utils → Test data generator (UserGenerator)
│
└── test
    ├── UserCreateTest
    ├── UserLoginTest
    ├── CreateOrderTest
    └── BaseTest → Base configuration and test setup

---

🔹 Design Decisions

• API request logic separated from test classes
• Request bodies implemented using POJO models
• Random test data generated using Faker
• API clients encapsulate REST interactions
• Allure @Step annotations used for better reporting
• Cleanup logic implemented via @After
• Reusable base test configuration

---

🧪 Tech Stack

Tool	Purpose
Java 11	Core language
JUnit 4	Test framework
Rest Assured	HTTP client for API testing
Allure	Test reporting
Java Faker	Random test data generation
Maven	Build & dependency management
Lombok	Boilerplate reduction

---

▶ How to Run Tests

Run all tests using Maven:

mvn clean test

---

📊 Allure Report

Generate interactive test report:

mvn allure:serve

The report includes:

• Detailed execution steps
• Request and response logs
• Test execution timeline
• Failure analysis

---

📈 What This Project Demonstrates

• REST API testing fundamentals
• Validation of positive and negative scenarios
• Understanding of HTTP status codes
• Clean test architecture
• Maintainable test automation framework
• Experience working with API reporting tools

---

👨‍💻 Author

Nikita Makoveev