REST Assured Tutorial 9 – Let’s Write First POST Request in REST Assured

As a part of End to End REST Assured Tutorial , in this post We will write first POST request in REST assured.

I will strongly recommended you to learn basics of API testing from here.

To learn what is POST request and how can you hit a POST request in Postman tool, must refer this post.

We will automate a POST request named “GetAuth” from Restful Booker. We will perform some validations like status code as well.

GetAuth API takes body as below where you need to pass username and password. If you pass credentials correctly, you will get token else error message.

 
{
    "username" : "admin",
    "password" : "password123"
}
 

Let’s start writing a POST request in REST Assured using both BDD and Non-BDD style. We will see multiple ways of writing same test as well.

We know that we need to pass a payload ( JSON or XML) to POST request. REST Assured makes it very handy to pass body to request. We can pass body as a String or a JSON file or a XML file or a Java Object or a byte array. We will see all ways in upcoming posts but as of now we will pass body as a String.

package RestfulBooker.postExamples;

import org.hamcrest.Matchers;

import io.restassured.RestAssured;
import io.restassured.http.ContentType;
import io.restassured.response.Response;
import io.restassured.response.ValidatableResponse;
import io.restassured.specification.RequestSpecification;

public class NonBDDStylePostRequest {
        
        
        public static void main(String[] args) {
                
                // There is no need to add escape character manually. Just paste string within double 
                // quotes. It will automatically add escape sequence as required. 
                String jsonString = "{\"username\" : \"admin\",\"password\" : \"password123\"}";
                
                // Create a request specification 
                RequestSpecification request= RestAssured.given();
                
                // Setting content type to specify format in which request payload will be sent.
                // ContentType is an ENUM. 
                request.contentType(ContentType.JSON);
                //Adding URI
                request.baseUri("https://restful-booker.herokuapp.com/auth");
                // Adding body as string
                request.body(jsonString);
                
                // Calling POST method on URI. After hitting we get Response
                Response response = request.post();
                
                // Printing Response as string
                System.out.println(response.asString());
                
                // Get Validatable response to perform validation
                ValidatableResponse validatableResponse = response.then();
                
                // Validate status code as 200
                validatableResponse.statusCode(200);
                
                // Validate token field is null
                // SInce response is one to one mapping so passing key name will give you value.
                // Below method validates that value of token is not null.
                validatableResponse.body("token", Matchers.notNullValue());
                
                // Validate token length is 15
                validatableResponse.body("token.length()", Matchers.is(15));
                
                // Validate token is an alphanumeric value
                validatableResponse.body("token", Matchers.matchesRegex("^[a-z0-9]+$"));
        }

}

package RestfulBooker.postExamples;

import org.hamcrest.Matchers;

import io.restassured.RestAssured;
import io.restassured.http.ContentType;

public class BDDStylePostRequest {
        
        
        public static void main(String[] args) {
                
                // There is no need to add escape character manually. Just paste string within double 
                // quotes. It will automatically add escape sequence as required. 
                String jsonString = "{\"username\" : \"admin\",\"password\" : \"password123\"}";
                
                
                //GIVEN
                RestAssured
                .given()
                        .baseUri("https://restful-booker.herokuapp.com/auth")
                        .contentType(ContentType.JSON)
                        .body(jsonString)
                // WHEN
                .when()
                        .post()
                // THEN
                .then()
                        .assertThat()
                        .statusCode(200)
                        .body("token", Matchers.notNullValue())
                        .body("token.length()", Matchers.is(15))
                        .body("token", Matchers.matchesRegex("^[a-z0-9]+$"));
                
        
        }

}

You can clone/download example repo here.

If you have any doubt, feel free to comment below.If you like my posts, please like, comment, share and subscribe.#ThanksForReading

#HappyLearning