Let Us Write First PUT Request in REST Assured

Steps to Write a PUT Request

• Create JSON data using a simple JSON library.
• Send the JSON content in the body of the Request.
• Validate the response.

Let us discuss the steps below:

Make The JSON Data Using the Simple JSON Library

We will use a Public API to explain the PUT method in this article. Here we have all the Requests like PUT, PATCH, GET, and DELETE. In this article, our work is with PUT. You also make your local API for testing.

Send JSON Content in the Request’s Body

The Request is then sent to the server.

body(request.toJSONString()).
when().
put("https://reqres.in/api/users/2")

So we have created a request body as the JSON string, and then we have to call the "put()" method by sending the Reqress PUT link as an argument. This ensures that the record with the given Reqress data is completely updated.

Validate the Response

The next step is validating the response to ensure the record update. This is done by reading the particular status code of the response as follows:

then().
statusCode(201);

The steps discussed above are used to show the working of a PUT request and how it also differs from a POST request. We used the JSON library to create JSON data sent in the content of the body of the Request. We then have to validate the response using the status code after obtaining the response. I have successfully obtained the 201 status code.

Code

// Import all necessary classes
import org.testng.annotations.Test;
import org.json.simple.JSONObject;
import static io.restassured.RestAssured.*;
import io.restassured.http.ContentType;
import io.restassured.response.Response;
import org.codehaus.groovy.reflection.ReflectionCache;
public class Test_PUT {
    @Test
    void TEST_put() {
            // Create object of JSONObject type
            JSONObject request = new JSONObject();
            //passing data to be modified in put() as arguments
            request.put("name", "Aarya");
            request.put("job", "Developer");
            System.out.println(request);
            System.out.println(request.toJSONString());
            // Directly checking the status code of the given URL
            given().header("Content-Type", "application/json").contentType(ContentType.JSON).accept(ContentType.JSON).body(request.toJSONString()).
            when().
            put("https://reqres.in/api/users/2").
            then().
            statusCode(200);
    }
}

You can also try this code with Online Java Compiler

Run Code

Output

As we can see, our test code has passed successfully.

Status Codes

For a PUT request: HTTP 200, HTTP 204 should imply "resource updated successfully". HTTP 201 if the PUT request created a new resource. In the code shown above, We are getting a 201 status code which implies the put request has updated the data and means that the work has been done successfully.

Frequently Asked Questions

Does it return 200 or 201?

For any successful resource operations like modification (PUT), a 200 (OK) or 202 Accepted code is acceptable and returned. The 200 response code signifies that the modification was immediately completed.

Can we create using put?

No, PUT is not for an update or create. It is for replacement. You can not replace anything with something for the effect of making.

What should I return in PUT?

PUT should never return a body but must return a response code in the header. 

What is the difference between PATCH, PUT and POST?

POST is always for creating a resource (it does not matter if it was duplicated ), and PUT is for checking if the resource exists and then updating it. Else create a new resource. PATCH is always for updating a resource.

Is put for an update or create?

PUT creates and updates a resource's state on the server.

Conclusion

So basically, in this article, we have learned how to write a PUT request in Rest Assure. Three main steps are needed to be followed. I have mentioned an explanation for each point. To learn more about Rest API, check the link below:

• What is Rest API
• How to Build a Rest API
• Building REST API with Bottle Framework

Refer to our guided paths on Coding Ninjas Studio to learn more about DSA, Competitive Programming, JavaScript, System Design, etc. Enroll in our courses and refer to the mock test and problems available. Take a look at the interview experiences and interview bundle for placement preparations.

Keep Coding!