REST Assured

{
  "id": 1,
  "name": "Rahul Sharma",
  "email": "rahul@example.com",
  "role": "tester",
  "active": true
}

<!-- Add inside <dependencies> tag in pom.xml -->

<!-- REST Assured -->
<dependency>
    <groupId>io.rest-assured</groupId>
    <artifactId>rest-assured</artifactId>
    <version>5.4.0</version>
    <scope>test</scope>
</dependency>

<!-- TestNG -->
<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.9.0</version>
    <scope>test</scope>
</dependency>

<!-- JSON Schema Validation (optional but useful) -->
<dependency>
    <groupId>io.rest-assured</groupId>
    <artifactId>json-schema-validator</artifactId>
    <version>5.4.0</version>
</dependency>

import io.restassured.RestAssured;
import static io.restassured.RestAssured.*;
import static org.hamcrest.Matchers.*;
import org.testng.annotations.Test;

public class FirstTest {

    @Test
    public void testGetUser() {

        given()
            .log().all()            // log the request details
        .when()
            .get("https://reqres.in/api/users/2")
        .then()
            .log().all()            // log the response details
            .statusCode(200)      // assert status code is 200
            .body("data.email", containsString("janet"));
    }
}

given()
    .baseUri("https://reqres.in")
    .header("Content-Type", "application/json")

.when()
    .get("/api/users?page=2")

.then()
    .statusCode(200)
    .body("page", equalTo(2))
    .body("data.size()", greaterThan(0));

@Test
public void getUsers() {
    given()
    .when()
        .get("https://reqres.in/api/users/1")
    .then()
        .statusCode(200)
        .body("data.id", equalTo(1));
}

@Test
public void createUser() {
    String body = "{ \"name\": \"Rahul\", \"job\": \"tester\" }";

    given()
        .header("Content-Type", "application/json")
        .body(body)
    .when()
        .post("https://reqres.in/api/users")
    .then()
        .statusCode(201)
        .body("name", equalTo("Rahul"));
}

@Test
public void updateUser() {
    String body = "{ \"name\": \"Rahul Updated\", \"job\": \"senior tester\" }";

    given()
        .header("Content-Type", "application/json")
        .body(body)
    .when()
        .put("https://reqres.in/api/users/2")
    .then()
        .statusCode(200)
        .body("name", equalTo("Rahul Updated"));
}

@Test
public void deleteUser() {
    given()
    .when()
        .delete("https://reqres.in/api/users/2")
    .then()
        .statusCode(204);  // 204 means deleted, no content returned
}

given()
    .queryParam("page", 2)
    .queryParam("per_page", 5)
.when()
    .get("https://reqres.in/api/users")
.then()
    .statusCode(200)
    .body("page", equalTo(2));

given()
    .pathParam("userId", 3)
.when()
    .get("https://reqres.in/api/users/{userId}")
.then()
    .statusCode(200)
    .body("data.id", equalTo(3));

given()
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .header("x-api-key", "your-api-key-here")
.when()
    .get("https://api.example.com/products")
.then()
    .statusCode(200);

String requestBody = "{" +
        "\"name\": \"Priya\"," +
        "\"job\": \"QA Engineer\"" +
        "}";

given()
    .contentType("application/json")
    .body(requestBody)
.when()
    .post("https://reqres.in/api/users")
.then()
    .statusCode(201);

import java.util.HashMap;

HashMap<String, String> map = new HashMap<>();
map.put("name", "Priya");
map.put("job", "QA Engineer");

given()
    .contentType("application/json")
    .body(map)
.when()
    .post("https://reqres.in/api/users")
.then()
    .statusCode(201)
    .body("name", equalTo("Priya"));

given()
.when()
    .get("https://reqres.in/api/users?page=1")
.then()
    .statusCode(200)
    .body("page", equalTo(1))
    .body("per_page", equalTo(6))
    .body("data", hasSize(6))
    .body("data[0].email", containsString("@"))
    .body("data[0].id", notNullValue())
    .body("total", greaterThan(5));

import io.restassured.response.Response;

@Test
public void extractUserData() {
    Response response = given()
    .when()
        .get("https://reqres.in/api/users/2")
    .then()
        .statusCode(200)
        .extract().response();

    // Extract individual values
    String email = response.jsonPath().getString("data.email");
    int id    = response.jsonPath().getInt("data.id");
    String name  = response.jsonPath().getString("data.first_name");

    System.out.println("Email: " + email);
    System.out.println("ID: " + id);
    System.out.println("Name: " + name);
}

String token = given()
    .contentType("application/json")
    .body("{ \"email\": \"eve.holt@reqres.in\", \"password\": \"cityslicka\" }")
.when()
    .post("https://reqres.in/api/login")
.then()
    .statusCode(200)
    .extract().path("token");   // extract the token directly

System.out.println("Token: " + token);

given()
    .auth().basic("username", "password")
.when()
    .get("https://api.example.com/profile")
.then()
    .statusCode(200);

String token = "eyJhbGciOiJIUzI1NiJ9..."; // JWT token

given()
    .header("Authorization", "Bearer " + token)
.when()
    .get("https://api.example.com/dashboard")
.then()
    .statusCode(200);

given()
    .auth().oauth2("your-oauth2-access-token")
.when()
    .get("https://api.example.com/data")
.then()
    .statusCode(200);

import io.restassured.RestAssured;
import org.testng.annotations.BeforeClass;

public class BaseTest {

    @BeforeClass
    public void setup() {
        // Set once, used in all tests in this class
        RestAssured.baseURI = "https://reqres.in";
        RestAssured.basePath = "/api";
    }
}

import io.restassured.specification.RequestSpecification;
import io.restassured.builder.RequestSpecBuilder;

RequestSpecification spec = new RequestSpecBuilder()
    .setBaseUri("https://reqres.in")
    .setBasePath("/api")
    .addHeader("Content-Type", "application/json")
    .addHeader("Authorization", "Bearer " + token)
    .build();

// Use in any test:
given(spec)
.when()
    .get("/users/1")   // base URL is already set in spec
.then()
    .statusCode(200);

given()
    .log().all()               // log everything in the request
    .header("Accept", "application/json")
.when()
    .get("https://reqres.in/api/users/2")
.then()
    .log().ifValidationFails() // log response only if test fails
    .statusCode(200);

src/
├── test/
│   ├── java/
│   │   ├── base/
│   │   │   └── BaseTest.java        ← RequestSpec, setup, teardown
│   │   ├── tests/
│   │   │   ├── UserTests.java       ← Actual test methods
│   │   │   └── AuthTests.java
│   │   ├── utils/
│   │   │   └── ConfigReader.java    ← Read config.properties
│   │   └── pojo/
│   │       └── User.java            ← POJO classes for request/response
│   └── resources/
│       ├── config.properties        ← base URL, credentials
│       └── testng.xml               ← TestNG suite configuration
└── pom.xml