In our discussions of HTTP REST Methods, we went through the 

GET
request in our earlier tutorials. We have also discussed validations like
validating headers and the status of the response obtained from the server.
In this article, we'll discuss the next method in REST API i.e. the POST request
using Rest Assured library. We'll cover the following topics in this article.

 What is an HTTP POST request method?

 How to use POST request method using Rest Assured?
 Create a Request pointing to the Service Endpoint.
 Create a JSON request which contains all the fields.
 Add JSON body in the request and send the Request.
 Validate the Response.
 Changing the HTTP Method on a POST Request using Rest Assured.

What is an HTTP Post Request method?

We use the verb "Post" everywhere when we are dealing with the web. For
example, when we are submitting any registration form on a particular
webpage like Gmail. We provide the required data and click submit. So
through this action of submitting data, we are actually POSTING or sending
the data to the server. The verb "POST" in HTTP, also called as POST request
method in HTTP sends data to the server. In our example, we are sending our
names, email and decided password as data.

Now let's go to Swagger UI of

API https://demoqa.com/BookStore/v1/Books Next, let's create a new user
using POST request as shown in the following screenshot.
In the above example, we have provided all the details for the new user
including id and ISBN. When we "execute" requests we initiate a POST
request and send all the information to the server. On the server side, the
new user will be created with all the provided information and a response
will be sent back to the client. Look at the following screenshot.

Have a look at the "curl" command that has a POST request with all the data.
The operation is successful and hence we get the response code as 201.

The content-type parameter is "application/JSON" in the above example.

The data sent to the server by POST request can also be XML(content-type:
application/XML). This data is in the body of the HTTP request. As we learned
from the above example, the POST method usually creates a new record in
the application database. Although, it is not always true. Sometimes in
creating web applications we use POST request redirections to ensure that no
one hits that URL directly without proper navigation channels. For example,
you must have noticed that refreshing or pressing "back" on payment pages
does not work directly. It is secure as the data being sent is not visible in the
URL string. The data can also be encrypted using HTTPS (HTTP Secure) to
enhance security.

As far as real-world applications are concerned, the POST request can have a
very big size and also a complex body structure. Since it provides an extra
layer of security, we often use it for passing sensitive business-related data. It
is also noteworthy here that the POST request does not always require all the
data to be filled by the user. It completely depends on the server
implementation and therefore you should always go through the
documentation before.

Let us now use Rest Assured to simulate an HTTP POST request.

How to use POST Request Method using Rest Assured?

In Rest Assured, we make use of the post() method to make an HTTP POST
request.

For making an HTTP Post request using Rest Assured, let's add a simple JSON
library in our classpath so that we can create JSON objects in the code. We
can use the following URL to download simple JSON from the
Maven: https://mvnrepository.com/artifact/com.googlecode.json-simple/
json-simple. Once the jar is downloaded we can add it to the classpath.

Following are the steps we'll follow to make a POST Request using Rest
Assured.

1. Create a Request pointing to the service Endpoint.

2. Create a JSON Request which contains all the fields.
3. Add JSON body in the request and send the request.
4. Validate the Request.
5. Changing the HTTP Method on a POST Request.

Let us now perform each step one by one.

Create a Request pointing to the Service Endpoint

We can start coding once the JSON jar downloads.

Consider following code lines.

RestAssured.baseURI = "https://demoqa.com/BookStore/v1/Books";
RequestSpecification request = RestAssured.given();
In the above code, we initialize a base URI with a link to the bookstore and
the 'createUser' API. Next, we create a 'request' using RequestSpecification.

Note: Above code is self-explanatory. In case of any problems, please refer to

previous tutorials.

Create a JSON request which contains all the fields

Next, we will create a JSON request object that will contain the data we need
to create a new user. Given below is the code for the same:

// JSONObject is a class that represents a Simple JSON.

// We can add Key - Value pairs using the put method
JSONObject requestParams = new JSONObject();
requestParams.put("userId", "TQ123");
requestParams.put("isbn", "9781449325862");
In the above code, we have created a JSONObject variable (JSONObject
belongs to org.json.simple package). Here we provide a JSON String
containing the data to post to the server.  Here we have
the requestParams object above for our test web service with multiple nodes
in the JSON. Each node is added to the JSON string using
the JSONObject.put(String, String) method. Once all the nodes are added in
this manner, we get the String representation of JSONObject by
calling JSONObject.toJSONString() method.

Add JSON body in the request and send the Request

Now that we have created the JSON string with the required data, the next
step will be to add this JSON to the request body and send or post the
request. Look at the following code:
// Add a header stating the Request body is a JSON
request.header("Content-Type", "application/json"); // Add the Json to the
body of the request
request.body(requestParams.toJSONString()); // Post the request and check
the response
So in this step, we simply add the JSON String to the body of the HTTP
Request and set the Content-Type header field value to application/JSON.
Next, we use the method RequestSpecification.body(JsonString) to put the
JSON body into the request. Using this method we can update the content of
the HTTP Request Body.

Next using the post () method on the request object we send this data to the
server using the 'BookStoreV1BooksPost' API.

Note: Calling the RequestSpecification.body method multiple times updates

the body each time to the latest JSON String.

Validate the Response

After posting the request we have to validate the response we received from
the server as a result of a POST request. Given below is the code for
validating the response:

Response response = request.post("/BookStoreV1BooksPost");

System.out.println("The status received: " + response.statusLine());
Here we read the status obtained using the statusLine() method and print it
to the console.

Changing the HTTP Method on a POST Request using Rest Assured

So what happens when we change the HTTP Request method on a POST

request? For example what happens when instead of the expected POST we
send the GET? Let's discuss this scenario.

Following is the code wherein we have sent a GET request to an Endpoint

when it actually expects POST.

public void UserRegistrationSuccessful()

{
RestAssured.baseURI ="https://demoqa.com/Account/v1";
RequestSpecification request = RestAssured.given();
JSONObject requestParams = new JSONObject();
requestParams.put("userName", "test_rest");
requestParams.put("password", "Testrest@123");
request.body(requestParams.toJSONString());
Response response = request.put("/User");
ResponseBody body = response.getBody();
System.out.println(response.getStatusLine());
System.out.println(body.asString());

}
When we execute the above code, we get the following response.

We can clearly see the output says the incorrect usage of the HTTP Request
Method. Similarly, we have other negative scenarios listed below which we will
leave to users to try themselves.

 Sending incomplete POST Data.

 Try Sending JSON data with incorrect syntax.
 Sending incorrect HTTP request method in the Request.

You can try the above scenarios on the same URL used above to demonstrate
the POST request.

Note: Corresponding Postman tutorial for Post request can be found at  Response
in Postman.