Echo Request Body

How it works

When a POST misbehaves, the first question is what actually went over the wire. An echo endpoint answers that: it parses the JSON you sent and returns it unchanged. The practice API's /echo replies 200 with the same keys, values and nesting, numbers stay numbers, and null stays null.

The endpoint has rules of its own. It only accepts POST, so a GET receives 405 Method Not Allowed with an Allow header naming POST. It only reads bodies sent as JSON, so a missing content type or malformed JSON both lead to 400 with a message asking for a JSON payload.

About the assignment

You send a two-field JSON document to the echo endpoint and print both fields from the reply, proving that what REST Assured sent is exactly what you wrote.

What you will do

1. 1Build a request with given() and contentType() set to ContentType.JSON.
2. 2Put the two-field JSON from the starter comment in body().
3. 3Send it with post() to /echo and keep the Response.
4. 4Read message and framework with getString() and print them after the labels from the task.

Common mistakes

• Expecting 201 from the echo

  Nothing is created, so the status is 200. A copied statusCode(201) check from a create test fails here.

• Forgetting the content type

  Without contentType() the body is sent as plain text and the reply is 400, even though the string itself is valid JSON. The error message spells out the header it needs.

• Calling it with GET

  The route exists only for POST, so get() returns 405 rather than 404. Read the Allow header when an endpoint rejects the method.

In a real test suite

Related lessons

• Create a User with POSTPOST a four-field user and read values from the created record.
• Echo Request HeadersThe header counterpart: send custom headers and read them echoed back.
• Conditional Request LoggingLog the request details, body included, whenever a check in the chain fails.

To try one of these calls on any API endpoint without a task, open the Online Selenium Java Compiler (REST Assured is included).

Starter code

The editor above opens with this code. Fill in the TODO lines, then run and submit it.

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

public class Main {
    public static void main(String[] args) {
        RestAssured.baseURI = "https://testkru.com/api";

        // TODO: POST to /echo with ContentType.JSON
        // Body: {"message": "Hello REST Assured", "framework": "REST Assured"}
        // TODO: Extract and print "message" and "framework" from the echoed response
    }
}