API Testing with Java Using Rest Assured – Sample Code Provided

Pritam January 4, 2020 Software Testing 2 Comments

Overview

Nowadays, software applications are becoming more complex at the same time more open for interactions. All thanks to APIs and it’s the ease of using with any kind of platform like mobile, web etc… If you’re super new to APIs, I suggest watching this YouTube video.

API Testing with Java Using Rest Assured:

In this article, our main focus will be on how to automate API testing with Java. For this, we will be using the most used library called Rest Assured. It is also an API specifically designed to automate our REST APIs.

1. Setup

So, the tools and software we required are as below:

Eclipse as our IDE
Java 8
TestNG testing framework
Maven for build automation

Here, I assume that you already have TestNG and Maven installed in Eclipse IDE.

1.1 Setting up Eclipse & Creating Maven Project

Once the project is set up, go to pom.xml file and add the required dependencies. We will download these dependencies from Maven official website.

1.2 Adding POM dependencies

<dependency>
    <groupId>io.rest-assured</groupId>
    <artifactId>rest-assured</artifactId>
    <version>4.1.1</version>
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>org.testng</groupId>
    <artifactId>testng</artifactId>
    <version>7.0.0</version>
    <scope>test</scope>
</dependency>

<dependency>
    <groupId>com.googlecode.json-simple</groupId>
    <artifactId>json-simple</artifactId>
    <version>1.1.1</version>
</dependency>

<groupId>io.rest-assured</groupId>

<artifactId>rest-assured</artifactId>

</dependency>

<groupId>org.testng</groupId>

<artifactId>testng</artifactId>

</dependency>

<groupId>com.googlecode.json-simple</groupId>

<artifactId>json-simple</artifactId>

</dependency>

2. Simple API Testing with Java example

Let’s understand a basic structure of JSON response you might get and how we validate using java rest-assured library. Consider below is the JSON response we got from a server at http://localhost:8080/data?id=4

{
"data":{
  "id":"4", 
  "name":"Niswa", 
  "job":"Software Engineer",
  "location":"New York"
}
}

{

"data":{

"id":"4",

"name":"Niswa",

"job":"Software Engineer",

"location":"New York"

}

Once you have something like this, REST assured comes handy to validate. Let’s see a simple test for validating the above response.

@Test
public void validateDataOnResponse() {
when().
 get("/data?id=4").
then().
 statusCode(200).assertThat()
  .body("data.name", equalTo("Niswa"));
}

@Test

public void validateDataOnResponse() {

when().

get("/data?id=4").

then().

statusCode(200).assertThat()

.body("data.name", equalTo("Niswa"));

}

From the above snippet, we have function validateDataOnResponse() which calls the API endpoint /data?id=4 and we get a response back in JSON format. We have then verified the statusCode as 200 and asserted that the body of JSON contains a name as “Niswa”.

Read: Build A Simple API using NodeJS

3. Tests for GET, POST, PUT, DELETE Methods

For all the below tests, we will use hosted APIs on reqres. This is one of my favorite hosted REST-API service available out there for free and without any sign or key.

3.1 GET method test example

We will create a single file for all the tests. Although, it is not recommended, but for us just to get started, It’s okay :). Now, in our first test, we will make a GET call and verify the statusCode to be 200.

Create a class name ApiMethodTests.java

import org.testng.annotations.Test;
import io.restassured.RestAssured;
import io.restassured.http.Method;
import io.restassured.response.Response;
import io.restassured.specification.RequestSpecification;

public class ApiMethodsTests {

    @Test
    void getUserDetailsTest() {
        //The base URI to be used
        RestAssured.baseURI = "https://reqres.in/api/users/";

        //Define the specification of request. Server is specified by baseURI above.
        RequestSpecification httpRequest = RestAssured.given();

        //Makes calls to the server using Method type.
        Response response = httpRequest.request(Method.GET, "2");

        //Checks the Status Code
        int statusCode = response.getStatusCode();
        Assert.assertEquals(statusCode, 200);
    }
}

import org.testng.annotations.Test;

import io.restassured.RestAssured;

import io.restassured.http.Method;

import io.restassured.response.Response;

import io.restassured.specification.RequestSpecification;

public class ApiMethodsTests {

@Test

void getUserDetailsTest() {

//The base URI to be used

RestAssured.baseURI = "https://reqres.in/api/users/";

//Define the specification of request. Server is specified by baseURI above.

RequestSpecification httpRequest = RestAssured.given();

//Makes calls to the server using Method type.

Response response = httpRequest.request(Method.GET, "2");

//Checks the Status Code

int statusCode = response.getStatusCode();

Assert.assertEquals(statusCode, 200);

}

3.2 POST method test example

In the same class, we will create a new test function and try to verify if the POST call is working and verify if a new user is created by asserting the statusCode as 201.

@Test
    void updateUserDetailsTest() {
        RestAssured.baseURI = "https://reqres.in/api/users/";

        RequestSpecification httpRequest = RestAssured.given();

        JSONObject updateData = new JSONObject();
        updateData.put("name", "Aarna");

        httpRequest.header("Content-Type", "application/json");

        httpRequest.body(updateData.toJSONString());
        Response response = httpRequest.request(Method.PUT, "4");
        statusCode = response.getStatusCode();
        Assert.assertEquals(statusCode, 200);

        JsonPath newData = response.jsonPath();
        String name = newData.get("name");
        Assert.assertEquals(name, "Aarna");
    }

@Test

void updateUserDetailsTest() {

RestAssured.baseURI = "https://reqres.in/api/users/";

RequestSpecification httpRequest = RestAssured.given();

JSONObject updateData = new JSONObject();

updateData.put("name", "Aarna");

httpRequest.header("Content-Type", "application/json");

httpRequest.body(updateData.toJSONString());

Response response = httpRequest.request(Method.PUT, "4");

statusCode = response.getStatusCode();

Assert.assertEquals(statusCode, 200);

JsonPath newData = response.jsonPath();

String name = newData.get("name");

Assert.assertEquals(name, "Aarna");

}

3.3 PUT method test example

This method is used to update the existing data. For example, you made a spelling mistake and now you want to correct, you’ll use PUT method. So. Let’s see how we can automate and do API testing with java for this kind of APIs.

@Test
    void updateUserDetailsTest() {
        RestAssured.baseURI = "https://reqres.in/api/users/";

        RequestSpecification httpRequest = RestAssured.given();

        //Passing the data to be updated
        JSONObject updateData = new JSONObject();
        updateData.put("name", "Aarna");

        httpRequest.header("Content-Type", "application/json");

        httpRequest.body(updateData.toJSONString());
        Response response = httpRequest.request(Method.PUT, "4");

        statusCode = response.getStatusCode();
        Assert.assertEquals(statusCode, 200);

        //Checking in response if data is updated
        JsonPath newData = response.jsonPath();
        String name = newData.get("name");
        Assert.assertEquals(name, "Aarna");
    }

@Test

void updateUserDetailsTest() {

RestAssured.baseURI = "https://reqres.in/api/users/";

RequestSpecification httpRequest = RestAssured.given();

//Passing the data to be updated

JSONObject updateData = new JSONObject();

updateData.put("name", "Aarna");

httpRequest.header("Content-Type", "application/json");

httpRequest.body(updateData.toJSONString());

Response response = httpRequest.request(Method.PUT, "4");

statusCode = response.getStatusCode();

Assert.assertEquals(statusCode, 200);

//Checking in response if data is updated

JsonPath newData = response.jsonPath();

String name = newData.get("name");

Assert.assertEquals(name, "Aarna");

}

3.4 DELETE method test example

In this example, we will delete an existing user and verify the status code. Note that the endpoint I am using the code sends back statusCode as 204 which is No Content and used as one of the valid codes for DELETE method.

@Test
    void deleteUserTest() {
        RestAssured.baseURI = "https://reqres.in/api/users/";

        RequestSpecification httpRequest = RestAssured.given();

        Response response = httpRequest.request(Method.DELETE, "4");
        statusCode = response.getStatusCode();
        Assert.assertEquals(statusCode, 204);
    }

@Test

void deleteUserTest() {

RestAssured.baseURI = "https://reqres.in/api/users/";

RequestSpecification httpRequest = RestAssured.given();

Response response = httpRequest.request(Method.DELETE, "4");

statusCode = response.getStatusCode();

Assert.assertEquals(statusCode, 204);

}

4. Bonus: API testing with Java for APIs which required Authorization

Nowadays, we have always seen that we require some type of authentication to access/use the API. This is important from a security standpoint and there are many different types of Authorization available like Basic Auth, Digest or OAuth etc. I will not go in detail about it, you can read more about it here.

Below you can see I tried to call this API without using Basic Auth and you can see the error and statusCode as 401 Unauthorized.

In this test, we will use the endpoint as – https://postman-echo.com/basic-auth and try to do GET call passing our Basic Auth credentials which this API accepts.

@Test
    void checkAuthorizationTest() {
        RestAssured.baseURI = "https://postman-echo.com/basic-auth";

        RequestSpecification httpRequest = RestAssured.given();

        Response response = httpRequest.request(Method.GET, "/");

        //Expecting unauthorized status 401
        statusCode = response.getStatusCode();
        Assert.assertEquals(statusCode, 401);

        //Passing the Basic Auth username and password
        httpRequest.auth().preemptive().basic("postman", "password");

        //Expecting our Auth works and verifying status code
        Response responseWithAuth = httpRequest.request(Method.GET, "/");
        statusCode = responseWithAuth.getStatusCode();
        Assert.assertEquals(statusCode, 200);

        //Verifying the response body of this API 
        JsonPath jsonValidator = responseWithAuth.jsonPath();
        Boolean authentication = jsonValidator.get("authenticated");
        Assert.assertTrue(authentication);
    }
}

@Test

void checkAuthorizationTest() {

RestAssured.baseURI = "https://postman-echo.com/basic-auth";

RequestSpecification httpRequest = RestAssured.given();

Response response = httpRequest.request(Method.GET, "/");

//Expecting unauthorized status 401

statusCode = response.getStatusCode();

Assert.assertEquals(statusCode, 401);

//Passing the Basic Auth username and password

httpRequest.auth().preemptive().basic("postman", "password");

//Expecting our Auth works and verifying status code

Response responseWithAuth = httpRequest.request(Method.GET, "/");

statusCode = responseWithAuth.getStatusCode();

Assert.assertEquals(statusCode, 200);

//Verifying the response body of this API

JsonPath jsonValidator = responseWithAuth.jsonPath();

Boolean authentication = jsonValidator.get("authenticated");

Assert.assertTrue(authentication);

}

Conclusion

So, above are all code sample for API testing with Java and we used rest assured library to do the same. Of course, there might be many other options as well. So, let me know in the comment section do you use something else interesting or need more help with REST assured, I will be more than happy to do so 🙂

DOWNLOAD CODE

2 Comments

Yabba
January 7, 2022 | Reply

Can u recheck your Post call. YOu h

Yabba
January 7, 2022 | Reply

Can u recheck your Post call. You have posted the code for PUT as the POST call

API Testing with Java Using Rest Assured – Sample Code Provided

Overview

API Testing with Java Using Rest Assured:

1. Setup

1.1 Setting up Eclipse & Creating Maven Project

1.2 Adding POM dependencies

2. Simple API Testing with Java example

3. Tests for GET, POST, PUT, DELETE Methods

3.1 GET method test example

3.2 POST method test example

3.3 PUT method test example

3.4 DELETE method test example

4. Bonus: API testing with Java for APIs which required Authorization

Conclusion

Add a Comment

Openstrap 2.0.3

Awakening 2.0.3

Aadya 2.0.3

Overview

API Testing with Java Using Rest Assured:

1. Setup

1.1 Setting up Eclipse & Creating Maven Project

1.2 Adding POM dependencies

2. Simple API Testing with Java example

3. Tests for GET, POST, PUT, DELETE Methods

3.1 GET method test example

3.2 POST method test example

3.3 PUT method test example

3.4 DELETE method test example

4. Bonus: API testing with Java for APIs which required Authorization

Conclusion

Related Posts

Add a Comment

Openstrap 2.0.3

Awakening 2.0.3

Aadya 2.0.3