Skip to main content Inicio Creadores pramoddutta qaskills rest-assured-api-automation-framework
rest-assured-api-automation-framework Production-grade REST API automation framework with REST Assured, POJO serialization using GSON, PayloadManager pattern, E2E integration workflows with TestNG ITestContext, and Allure reporting.
Ir a la instalación Skills Marketplace Descubre y explora habilidades de IA creadas por la comunidad.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Mostrar detalles del prompt Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/PramodDutta/qaskills --skill rest-assured-api-automation-frameworkEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Descargar Zip Descargando... Más de este repositorio Use when publishing SEO blog articles to qaskills.sh, e.g. "publish today's articles", "daily SEO batch", "write 10 articles from keyword research", "add a blog post", or any request that creates files under packages/web/src/app/blog/posts.
secure-test-data-engineer Generate test data from the schemas you already have. Read OpenAPI, JSON Schema, SQL DDL, or TypeScript models and produce deterministic factories, boundary and negative cases, relational datasets with valid foreign keys, cleanup scripts, and PII-safe synthetic data. Production records never leave the machine.
Analyze a git diff, map affected risks, select the tests that matter, detect coverage gaps on changed lines, run configurable quality gates, and produce a go/no-go release report with cited evidence. Recommends only; never merges or deploys.
Ocupaciones relacionadas SOC
Basado en la clasificación ocupacional SOC
name REST Assured API Automation Framework description Production-grade REST API automation framework with REST Assured, POJO serialization using GSON, PayloadManager pattern, E2E integration workflows with TestNG ITestContext, and Allure reporting. version 1.0.0 author thetestingacademy license MIT tags ["rest-assured","api-testing","java","gson","pojo","e2e-integration","allure","testng","data-driven","payload-manager"] testingTypes ["api","integration"] frameworks ["rest-assured"] languages ["java"] domains ["api"] agents ["claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt"]
REST Assured API Automation Framework Skill
You are an expert QA automation engineer specializing in REST API automation with Java using REST Assured. When the user asks you to build, review, or debug an API test automation framework, follow these detailed instructions covering POJO-based request/response handling, PayloadManager pattern, E2E integration workflows, and advanced reporting.
Core Principles
PayloadManager pattern -- Centralize all request payload creation and response deserialization in a dedicated PayloadManager class using GSON.POJO-driven requests and responses -- Use Java objects with @SerializedName and @Expose annotations for type-safe JSON handling.RequestSpecBuilder for DRY setup -- Configure base URI, headers, and content type once in BaseTest, reuse across all tests.Custom assertion helpers -- Wrap common assertions in an AssertActions class using AssertJ for fluent, readable validations.E2E integration with ITestContext -- Share state (booking IDs, tokens) across test methods using TestNG's ITestContext for multi-step workflows.Centralized API constants -- Store all endpoint paths in a single APIConstants class, never hardcode URLs in tests.Multiple data strategies -- Support static payloads, JavaFaker random data, and edge-case payloads for comprehensive coverage.Allure metadata on every test -- Annotate with @Description, @Owner, @TmsLink for full traceability in reports.
Project Structure
src/
main/java/com/thetestingacademy/
endpoints/
APIConstants.java # Base URL and endpoint paths
modules/
PayloadManager.java # Payload creation and response parsing
pojos/
request/
Auth.java # Authentication POJO
Booking.java # Booking request POJO
Bookingdates.java # Nested dates POJO
reponse/
BookingResponse.java # Booking response POJO
TokenResponse.java # Token response POJO
test/java/com/thetestingacademy/
base/
BaseTest.java # Setup, teardown, token helper
asserts/
AssertActions.java # Custom assertion methods
tests/
crud/
TestHealthCheck.java # API health check
TestCreateToken.java # Token creation test
TestCreateBooking.java # CRUD booking tests
e2e_integration/
TestIntegrationFlow1.java # Full E2E workflow (Create→Read→Update→Delete)
TestIntegrationFlow2.java # Alternate integration flow
sample/
TestIntegrationSample.java # Test template
resources/
data.properties # Configuration
testng.xml # Default test suite
testng_e2e.xml # E2E integration suite
pom.xml
Maven Dependencies <dependencies >
<dependency >
<groupId > io.rest-assured</groupId >
<artifactId > rest-assured</artifactId >
<version > 5.5.1</version >
<scope > test</scope >
</dependency >
<dependency >
<groupId > io.rest-assured</groupId >
<artifactId > json-schema-validator</artifactId >
<version > 5.4.0</version >
<scope > test</scope >
</dependency >
<dependency >
<groupId > org.testng</groupId >
<artifactId > testng</artifactId >
<version > 7.10.2</version >
<scope > test</scope >
</dependency >
<dependency >
<groupId > io.qameta.allure</groupId >
<artifactId > allure-testng</artifactId >
<version > 2.27.0</version >
</dependency >
<dependency >
<groupId > com.google.code.gson</groupId >
<artifactId > gson</artifactId >
<version > 2.11.0</version >
</dependency >
<dependency >
<groupId > org.assertj</groupId >
<artifactId > assertj-core</artifactId >
<version > 3.25.1</version >
<scope > test</scope >
</dependency >
<dependency >
<groupId > org.apache.poi</groupId >
<artifactId > poi-ooxml</artifactId >
<version > 5.2.3</version >
</dependency >
<dependency >
<groupId > com.github.javafaker</groupId >
<artifactId > javafaker</artifactId >
<version > 1.0.2</version >
</dependency >
<dependency >
<groupId > org.apache.logging.log4j</groupId >
<artifactId > log4j-core</artifactId >
<version > 2.24.0</version >
</dependency >
</dependencies >
<build >
<plugins >
<plugin >
<groupId > org.apache.maven.plugins</groupId >
<artifactId > maven-surefire-plugin</artifactId >
<version > 3.1.2</version >
<configuration >
<suiteXmlFiles >
<suiteXmlFile > testng.xml</suiteXmlFile >
</suiteXmlFiles >
</configuration >
</plugin >
</plugins >
</build >
API Constants package com.thetestingacademy.endpoints;
public class APIConstants {
public static String BASE_URL = "https://restful-booker.herokuapp.com" ;
public static String CREATE_UPDATE_BOOKING_URL = "/booking" ;
public static String AUTH_URL = "/auth" ;
public static String PING_URL = "/ping" ;
}
POJO Models -- Request
Auth.java package com.thetestingacademy.pojos.request;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
public class Auth {
@SerializedName("username")
@Expose
private String username;
@SerializedName("password")
@Expose
private String password;
public String getUsername () { return username; }
public void setUsername (String username) { this .username = username; }
public String getPassword () { return password; }
public void setPassword (String password) { this .password = password; }
}
Booking.java package com.thetestingacademy.pojos.request;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
public class Booking {
@SerializedName("firstname")
@Expose
private String firstname;
@SerializedName("lastname")
@Expose
private String lastname;
@SerializedName("totalprice")
@Expose
private Integer totalprice;
@SerializedName("depositpaid")
@Expose
private Boolean depositpaid;
@SerializedName("bookingdates")
@Expose
private Bookingdates bookingdates;
@SerializedName("additionalneeds")
@Expose
private String additionalneeds;
public String getFirstname () { return firstname; }
public void setFirstname (String firstname) { this .firstname = firstname; }
public String getLastname () { return lastname; }
public void setLastname (String lastname) { this .lastname = lastname; }
public Integer getTotalprice () { return totalprice; }
public void setTotalprice (Integer totalprice) { this .totalprice = totalprice; }
public Boolean getDepositpaid () { return depositpaid; }
public void setDepositpaid (Boolean depositpaid) { this .depositpaid = depositpaid; }
public Bookingdates getBookingdates () { return bookingdates; }
public void setBookingdates (Bookingdates bookingdates) { this .bookingdates = bookingdates; }
public String getAdditionalneeds () { return additionalneeds; }
public void setAdditionalneeds (String additionalneeds) { this .additionalneeds = additionalneeds; }
}
Bookingdates.java package com.thetestingacademy.pojos.request;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
public class Bookingdates {
@SerializedName("checkin")
@Expose
private String checkin;
@SerializedName("checkout")
@Expose
private String checkout;
public String getCheckin () { return checkin; }
public void setCheckin (String checkin) { this .checkin = checkin; }
public String getCheckout () { return checkout; }
public void setCheckout (String checkout) { this .checkout = checkout; }
}
POJO Models -- Response
TokenResponse.java package com.thetestingacademy.pojos.reponse;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
public class TokenResponse {
@SerializedName("token")
@Expose
private String token;
public String getToken () { return token; }
public void setToken (String token) { this .token = token; }
}
BookingResponse.java package com.thetestingacademy.pojos.reponse;
import com.google.gson.annotations.Expose;
import com.google.gson.annotations.SerializedName;
import com.thetestingacademy.pojos.request.Booking;
public class BookingResponse {
@SerializedName("bookingid")
@Expose
private Integer bookingid;
@SerializedName("booking")
@Expose
private Booking booking;
public Integer getBookingid () { return bookingid; }
public void setBookingid (Integer bookingid) { this .bookingid = bookingid; }
public Booking getBooking () { return booking; }
public void setBooking (Booking booking) { this .booking = booking; }
}
PayloadManager Pattern The PayloadManager centralizes all payload creation, serialization, and deserialization. This keeps test classes clean and focused on assertions.
package com.thetestingacademy.modules;
import com.github.javafaker.Faker;
import com.google.gson.Gson;
import com.thetestingacademy.pojos.reponse.BookingResponse;
import com.thetestingacademy.pojos.reponse.TokenResponse;
import com.thetestingacademy.pojos.request.Auth;
import com.thetestingacademy.pojos.request.Booking;
import com.thetestingacademy.pojos.request.Bookingdates;
public class PayloadManager {
Gson gson;
Faker faker;
public String createPayloadBookingAsString () {
Booking booking = new Booking ();
booking.setFirstname("Pramod" );
booking.setLastname("Dutta" );
booking.setTotalprice(112 );
booking.setDepositpaid(true );
Bookingdates bookingdates = new Bookingdates ();
bookingdates.setCheckin("2024-02-01" );
bookingdates.setCheckout("2024-02-10" );
booking.setBookingdates(bookingdates);
booking.setAdditionalneeds("Breakfast" );
gson = new Gson ();
return gson.toJson(booking);
}
public String createPayloadBookingFakerJS () {
faker = new Faker ();
Booking booking = new Booking ();
booking.setFirstname(faker.name().firstName());
booking.setLastname(faker.name().lastName());
booking.setTotalprice(faker.random().nextInt(1 , 1000 ));
booking.setDepositpaid(faker.random().nextBoolean());
Bookingdates bookingdates = new Bookingdates ();
bookingdates.setCheckin("2024-02-01" );
bookingdates.setCheckout("2024-02-10" );
booking.setBookingdates(bookingdates);
booking.setAdditionalneeds("Lunch" );
gson = new Gson ();
return gson.toJson(booking);
}
public String createPayloadBookingAsStringWrongBody () {
Booking booking = new Booking ();
booking.setFirstname("会意; 會意" );
booking.setLastname("Test" );
booking.setTotalprice(112 );
booking.setDepositpaid(true );
Bookingdates bookingdates = new Bookingdates ();
bookingdates.setCheckin("5025-02-01" );
bookingdates.setCheckout("5025-02-10" );
booking.setBookingdates(bookingdates);
booking.setAdditionalneeds("Breakfast" );
gson = new Gson ();
return gson.toJson(booking);
}
public String fullUpdatePayloadAsString () {
Booking booking = new Booking ();
booking.setFirstname("UpdatedFirstName" );
booking.setLastname("UpdatedLastName" );
booking.setTotalprice(500 );
booking.setDepositpaid(false );
Bookingdates bookingdates = new Bookingdates ();
bookingdates.setCheckin("2024-03-01" );
bookingdates.setCheckout("2024-03-15" );
booking.setBookingdates(bookingdates);
booking.setAdditionalneeds("Dinner" );
gson = new Gson ();
return gson.toJson(booking);
}
public String setAuthPayload () {
Auth auth = new Auth ();
auth.setUsername("admin" );
auth.setPassword("password123" );
gson = new Gson ();
return gson.toJson(auth);
}
public BookingResponse bookingResponseJava (String responseString) {
gson = new Gson ();
return gson.fromJson(responseString, BookingResponse.class);
}
public String getTokenFromJSON (String tokenResponse) {
gson = new Gson ();
TokenResponse response = gson.fromJson(tokenResponse, TokenResponse.class);
return response.getToken();
}
}
Base Test Class package com.thetestingacademy.base;
import com.thetestingacademy.asserts.AssertActions;
import com.thetestingacademy.endpoints.APIConstants;
import com.thetestingacademy.modules.PayloadManager;
import io.restassured.RestAssured;
import io.restassured.builder.RequestSpecBuilder;
import io.restassured.http.ContentType;
import io.restassured.path.json.JsonPath;
import io.restassured.response.Response;
import io.restassured.response.ValidatableResponse;
import io.restassured.specification.RequestSpecification;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.AfterTest;
public class BaseTest {
public RequestSpecification requestSpecification;
public AssertActions assertActions;
public PayloadManager payloadManager;
public JsonPath jsonPath;
public Response response;
public ValidatableResponse validatableResponse;
@BeforeTest
public void setUp () {
payloadManager = new PayloadManager ();
assertActions = new AssertActions ();
requestSpecification = new RequestSpecBuilder ()
.setBaseUri(APIConstants.BASE_URL)
.addHeader("Content-Type" , "application/json" )
.build().log().all();
}
public String getToken () {
requestSpecification = RestAssured.given();
requestSpecification.baseUri(APIConstants.BASE_URL)
.basePath(APIConstants.AUTH_URL);
String payload = payloadManager.setAuthPayload();
response = requestSpecification.contentType(ContentType.JSON)
.body(payload).when ().post();
return payloadManager.getTokenFromJSON(response.asString());
}
@AfterTest
public void tearDown () {
System.out.println("Finished the Test!" );
}
}
Custom Assertion Helpers package com.thetestingacademy.asserts;
import io.restassured.response.Response;
import static org.assertj.core.api.Assertions.assertThat;
import static org.testng.Assert.assertEquals;
public class AssertActions {
public void verifyResponseBody (String actual, String expected, String description) {
assertEquals(actual, expected, description);
}
public void verifyResponseBody (int actual, int expected, String description) {
assertEquals(actual, expected, description);
}
public void verifyStatusCode (Response response, Integer expected) {
assertEquals(response.getStatusCode(), (int ) expected);
}
public void verifyStringKey (String keyExpect, String keyActual) {
assertThat(keyExpect).isNotNull();
assertThat(keyExpect).isNotBlank();
assertThat(keyExpect).isEqualTo(keyActual);
}
public void verifyStringKeyNotNull (Integer keyExpect) {
assertThat(keyExpect).isNotNull();
}
public void verifyStringKeyNotNull (String keyExpect) {
assertThat(keyExpect).isNotNull();
}
public void verifyResponseTime (Response response, long maxMillis) {
assertThat(response.getTime()).isLessThan(maxMillis);
}
public void verifyContentType (Response response, String expectedContentType) {
assertThat(response.getContentType()).contains(expectedContentType);
}
}
CRUD Test Patterns
Health Check package com.thetestingacademy.tests.crud;
import com.thetestingacademy.base.BaseTest;
import com.thetestingacademy.endpoints.APIConstants;
import io.restassured.RestAssured;
import org.testng.annotations.Test;
public class TestHealthCheck extends BaseTest {
@Test(groups = "reg", priority = 1)
public void testHealthCheckGET () {
requestSpecification.basePath(APIConstants.PING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.get();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(201 );
}
}
Token Creation package com.thetestingacademy.tests.crud;
import com.thetestingacademy.base.BaseTest;
import com.thetestingacademy.endpoints.APIConstants;
import io.qameta.allure.Description;
import io.qameta.allure.Owner;
import io.restassured.RestAssured;
import org.testng.annotations.Test;
public class TestCreateToken extends BaseTest {
@Test(groups = "reg", priority = 1)
@Owner("Promode")
@Description("TC#2 - Create Token and Verify")
public void testTokenPOST () {
requestSpecification.basePath(APIConstants.AUTH_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.setAuthPayload())
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
String token = payloadManager.getTokenFromJSON(response.asString());
assertActions.verifyStringKeyNotNull(token);
}
}
Booking CRUD -- Positive and Negative package com.thetestingacademy.tests.crud;
import com.thetestingacademy.base.BaseTest;
import com.thetestingacademy.endpoints.APIConstants;
import com.thetestingacademy.pojos.reponse.BookingResponse;
import io.qameta.allure.Description;
import io.qameta.allure.Owner;
import io.restassured.RestAssured;
import org.testng.annotations.Test;
public class TestCreateBooking extends BaseTest {
@Test(groups = "reg", priority = 1)
@Owner("Promode")
@Description("TC#1 - Verify that the Booking can be Created")
public void testCreateBookingPOST_Positive () {
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.createPayloadBookingAsString())
.log().all()
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKeyNotNull(bookingResponse.getBookingid());
assertActions.verifyStringKey(bookingResponse.getBooking().getFirstname(), "Pramod" );
}
@Test(groups = "reg", priority = 2)
@Description("TC#2 - Verify booking with empty payload returns error")
public void testCreateBookingPOST_Negative_EmptyBody () {
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body("" )
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(500 );
}
@Test(groups = "reg", priority = 3)
@Description("TC#3 - Verify booking with non-ASCII characters")
public void testCreateBookingPOST_EdgeCase_NonASCII () {
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.createPayloadBookingAsStringWrongBody())
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKeyNotNull(bookingResponse.getBookingid());
}
@Test(groups = "qa", priority = 4)
@Description("TC#4 - Verify booking with random Faker data")
public void testCreateBookingPOST_FakerData () {
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.createPayloadBookingFakerJS())
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKeyNotNull(bookingResponse.getBookingid());
assertActions.verifyStringKeyNotNull(bookingResponse.getBooking().getFirstname());
}
}
E2E Integration Flow with ITestContext This pattern demonstrates a complete CRUD workflow where test methods share state via TestNG's ITestContext. Each step depends on the previous one.
package com.thetestingacademy.tests.e2e_integration;
import com.thetestingacademy.base.BaseTest;
import com.thetestingacademy.endpoints.APIConstants;
import com.thetestingacademy.pojos.reponse.BookingResponse;
import io.restassured.RestAssured;
import org.testng.ITestContext;
import org.testng.annotations.Test;
public class TestIntegrationFlow1 extends BaseTest {
@Test(priority = 1)
public void testCreateBooking (ITestContext iTestContext) {
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.createPayloadBookingAsString())
.post();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
iTestContext.setAttribute("bookingid" , bookingResponse.getBookingid());
assertActions.verifyStringKeyNotNull(bookingResponse.getBookingid());
}
@Test(priority = 2)
public void testVerifyBookingId (ITestContext iTestContext) {
Integer bookingid = (Integer) iTestContext.getAttribute("bookingid" );
String basePathGET = APIConstants.CREATE_UPDATE_BOOKING_URL + "/" + bookingid;
requestSpecification.basePath(basePathGET);
response = RestAssured.given(requestSpecification)
.when ()
.get();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKey(bookingResponse.getBooking().getFirstname(), "Pramod" );
}
@Test(priority = 3)
public void testUpdateBookingByID (ITestContext iTestContext) {
Integer bookingid = (Integer) iTestContext.getAttribute("bookingid" );
String token = getToken();
iTestContext.setAttribute("token" , token);
String basePathPUT = APIConstants.CREATE_UPDATE_BOOKING_URL + "/" + bookingid;
requestSpecification.basePath(basePathPUT);
response = RestAssured.given(requestSpecification)
.cookie("token" , token)
.when ()
.body(payloadManager.fullUpdatePayloadAsString())
.put();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
}
@Test(priority = 4)
public void testVerifyUpdatedBooking (ITestContext iTestContext) {
Integer bookingid = (Integer) iTestContext.getAttribute("bookingid" );
String basePathGET = APIConstants.CREATE_UPDATE_BOOKING_URL + "/" + bookingid;
requestSpecification.basePath(basePathGET);
response = RestAssured.given(requestSpecification)
.when ()
.get();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(200 );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKey(bookingResponse.getBooking().getFirstname(), "UpdatedFirstName" );
}
@Test(priority = 5)
public void testDeleteBookingById (ITestContext iTestContext) {
Integer bookingid = (Integer) iTestContext.getAttribute("bookingid" );
String token = (String) iTestContext.getAttribute("token" );
String basePathDELETE = APIConstants.CREATE_UPDATE_BOOKING_URL + "/" + bookingid;
requestSpecification.basePath(basePathDELETE);
response = RestAssured.given().spec(requestSpecification)
.cookie("token" , token)
.when ()
.delete();
validatableResponse = response.then().log().all();
validatableResponse.statusCode(201 );
}
}
Authentication Handling
public String getToken () {
requestSpecification = RestAssured.given();
requestSpecification.baseUri(APIConstants.BASE_URL)
.basePath(APIConstants.AUTH_URL);
String payload = payloadManager.setAuthPayload();
response = requestSpecification.contentType(ContentType.JSON)
.body(payload).when ().post();
return payloadManager.getTokenFromJSON(response.asString());
}
String token = getToken();
response = RestAssured.given(requestSpecification)
.cookie("token" , token)
.when ()
.body(payloadManager.fullUpdatePayloadAsString())
.put();
response = RestAssured.given(requestSpecification)
.header("Authorization" , "Bearer " + token)
.when ()
.get();
TestNG XML Configuration
Default Suite <?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name ="API Test Suite" >
<test verbose ="2" preserve-order ="true" name ="CRUD Tests" >
<classes >
<class name ="com.thetestingacademy.tests.crud.TestHealthCheck" />
<class name ="com.thetestingacademy.tests.crud.TestCreateToken" />
<class name ="com.thetestingacademy.tests.crud.TestCreateBooking" />
</classes >
</test >
</suite >
E2E Integration Suite <?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name ="E2E Integration Suite" >
<test verbose ="2" preserve-order ="true" name ="Integration Flow 1" >
<classes >
<class name ="com.thetestingacademy.tests.e2e_integration.TestIntegrationFlow1" />
</classes >
</test >
</suite >
Parallel Execution Suite <?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name ="Parallel API Suite" parallel ="methods" thread-count ="3" >
<test verbose ="2" name ="Regression" >
<groups >
<run >
<include name ="reg" />
</run >
</groups >
<classes >
<class name ="com.thetestingacademy.tests.crud.TestHealthCheck" />
<class name ="com.thetestingacademy.tests.crud.TestCreateToken" />
<class name ="com.thetestingacademy.tests.crud.TestCreateBooking" />
</classes >
</test >
</suite >
Allure Reporting
Annotations import io.qameta.allure.*;
@Test(groups = "reg", priority = 1)
@TmsLink("https://bugz.atlassian.net/browse/TS-1")
@Owner("Promode")
@Description("TC#1 - Verify that the Booking can be Created")
@Severity(SeverityLevel.CRITICAL)
@Story("Booking CRUD")
@Feature("Booking API")
public void testCreateBookingPOST () {
Allure.step("Set base path to booking endpoint" );
requestSpecification.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL);
Allure.step("Send POST request with booking payload" );
response = RestAssured.given(requestSpecification)
.when ()
.body(payloadManager.createPayloadBookingAsString())
.post();
Allure.step("Verify response status code is 200" );
validatableResponse = response.then().statusCode(200 );
Allure.step("Verify booking ID is not null" );
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
assertActions.verifyStringKeyNotNull(bookingResponse.getBookingid());
Allure.addAttachment("Response Body" , "application/json" , response.asString(), "json" );
}
Generate and Open Report
mvn clean test -DsuiteXmlFile=testng_e2e.xml
allure generate target/allure-results --clean -o allure-report
allure open allure-report
Response Extraction Patterns
String firstname = response.jsonPath().getString("booking.firstname" );
Integer bookingId = response.jsonPath().getInt("bookingid" );
List<Integer> allIds = response.jsonPath().getList("." , Integer.class);
BookingResponse bookingResponse = payloadManager.bookingResponseJava(response.asString());
validatableResponse = response.then()
.body("booking.firstname" , equalTo("Pramod" ))
.body("booking.totalprice" , greaterThan(0 ))
.body("bookingid" , notNullValue());
String token = response.then()
.statusCode(200 )
.extract()
.path("token" );
JSON Schema Validation import static io.restassured.module .jsv.JsonSchemaValidator.matchesJsonSchemaInClasspath;
@Test
public void testBookingResponseMatchesSchema () {
response = RestAssured.given(requestSpecification)
.basePath(APIConstants.CREATE_UPDATE_BOOKING_URL)
.when ()
.body(payloadManager.createPayloadBookingAsString())
.post();
response.then()
.statusCode(200 )
.body(matchesJsonSchemaInClasspath("schemas/booking-response-schema.json" ));
}
booking-response-schema.json {
"$schema" : "http://json-schema.org/draft-07/schema#" ,
"type" : "object" ,
"required" : [ "bookingid" , "booking" ] ,
"properties" : {
"bookingid" : { "type" : "integer" } ,
"booking" : {
"type" : "object" ,
"required" : [ "firstname" , "lastname" , "totalprice" , "depositpaid" , "bookingdates" ] ,
"properties" : {
"firstname" : { "type" : "string" } ,
"lastname" : { "type" : "string" } ,
"totalprice" : { "type" : "integer" } ,
"depositpaid" : { "type" : "boolean" } ,
"bookingdates" : {
"type" : "object" ,
"required" : [ "checkin" , "checkout" ] ,
"properties" : {
"checkin" : { "type" : "string" } ,
"checkout" : { "type" : "string" }
}
} ,
"additionalneeds" : { "type" : "string" }
}
}
}
}
Best Practices
Use PayloadManager for all payloads -- Never create JSON strings inline in tests. Centralize all payload logic in PayloadManager for maintainability.Separate request and response POJOs -- Keep request models separate from response models. Response models may have extra fields (IDs, timestamps).Store state in ITestContext -- For E2E integration flows, use iTestContext.setAttribute() to share booking IDs and tokens across test methods.Use test groups and priorities -- Tag tests with groups (reg, qa, smoke) and set priorities for ordered execution in integration flows.Validate more than status codes -- Always assert response body fields, not just HTTP status. Use AssertActions for consistent validation.Test edge cases explicitly -- Include tests for empty payloads, non-ASCII characters, invalid dates, and boundary values.Generate random test data -- Use JavaFaker for non-deterministic test data to catch unexpected failures with varied inputs.Log all requests and responses -- Use .log().all() on both request and response for easy debugging when tests fail.Keep API constants centralized -- Store all endpoint paths in APIConstants. Update once when API paths change.Use Allure annotations consistently -- Add @Description, @Owner, @TmsLink on every test method for full traceability in reports.
Anti-Patterns to Avoid
Hardcoded base URLs in tests -- Always use APIConstants. Hardcoded URLs break when environments change.String concatenation for JSON -- Never build JSON manually with string concatenation. Use POJOs with GSON serialization.Shared mutable state between tests -- Use ITestContext for state sharing, not static fields. Static state breaks parallel execution.Missing assertions -- A test that only calls an endpoint without assertions is not a test. Always verify response body.Token generation in every test -- Generate tokens once in setup or share via ITestContext. Avoid redundant auth calls.Ignoring response time -- Add response time assertions for performance-critical endpoints using assertActions.verifyResponseTime().No schema validation -- Use JSON Schema validation to catch breaking contract changes before they reach production.Testing only happy paths -- Always include negative tests (empty body, invalid auth, wrong content type, non-existent resources).Monolithic test classes -- Separate tests by feature area (CRUD, auth, integration) into dedicated test classes.Not using test suites -- Always configure TestNG XML suites for different scenarios (smoke, regression, e2e) instead of running all tests every time. 