Why body format matches API expectations in Postman - Automation Benefits in Action

Verify API accepts correct JSON body format

Preconditions (3)

Step 1: Open Postman and create a new POST request

Step 2: Set the request URL to the API endpoint

Step 3: In the Body tab, select 'raw' and choose 'JSON' format

Step 4: Enter the JSON body: {"username": "testuser", "password": "Pass123!"}

Step 5: Send the request

Step 6: Observe the response status code and body

✅ Expected Result: The API responds with status code 200 and a success message indicating the body format was accepted

Automation Requirements - Postman/Newman

Assertions Needed:

Response status code is 200

Response body contains success confirmation

Best Practices:

Use JSON format in request body matching API schema

Validate response status and body content

Use environment variables for endpoint URLs

Add descriptive test names and comments

Automated Solution

Postman

pm.test('Status code is 200', function () {
    pm.response.to.have.status(200);
});

pm.test('Response has success message', function () {
    const jsonData = pm.response.json();
    pm.expect(jsonData.message).to.eql('Login successful');
});

The first test checks that the API returns a 200 status code, meaning the request was successful.

The second test parses the JSON response and verifies that the 'message' field equals 'Login successful', confirming the API accepted the body format.

Using pm.response and pm.expect ensures we use Postman's built-in assertion methods for clarity and reliability.

Common Mistakes - 3 Pitfalls

{'mistake': 'Sending body as plain text instead of JSON', 'why_bad': 'API expects JSON format; sending plain text causes parsing errors and request failure', 'correct_approach': "Set body type to 'raw' and select 'JSON' in Postman before entering JSON content"}

Using incorrect field names or missing required fields in JSON body

Not verifying response status code before checking response body

Bonus Challenge

Now add data-driven testing with 3 different sets of username and password combinations

Show Hint

Practice

1. Why is it important to match the Content-Type header with the body format in an API request?

easy

A. Because it hides the data from the server

B. Because it changes the API URL automatically

C. Because the API uses it to understand how to read the data sent

D. Because it speeds up the network connection

Solution

1. Step 1: Understand the role of Content-Type header

   The Content-Type header tells the API what format the request body is in, like JSON or XML.

2. Step 2: Explain why matching is necessary

   If the header doesn't match the body format, the API won't know how to read the data correctly and may return errors.

3. Final Answer:

   Because the API uses it to understand how to read the data sent -> Option C

4. Quick Check:

   Content-Type guides API to parse body = D [OK]

Hint: Match Content-Type header to body format to avoid errors [OK]

Common Mistakes:

• Thinking Content-Type changes the URL
• Assuming Content-Type affects speed
• Believing Content-Type hides data

2. Which of the following is the correct way to set a JSON body in Postman for an API expecting JSON data?

easy

A. Set the body type to 'x-www-form-urlencoded' and write JSON data

B. Set the body type to 'form-data' and write JSON as plain text

C. Set the body type to 'binary' and upload a JSON file

D. Set the body type to 'raw' and select 'JSON' from the dropdown, then write JSON data

Solution

1. Step 1: Identify correct body type for JSON in Postman

   Postman requires 'raw' body type with 'JSON' selected to send JSON data properly.

2. Step 2: Explain why other options are incorrect

   'form-data' and 'x-www-form-urlencoded' send data differently, not as raw JSON. 'binary' is for files, not text JSON.

3. Final Answer:

   Set the body type to 'raw' and select 'JSON' from the dropdown, then write JSON data -> Option D

4. Quick Check:

   Raw + JSON dropdown = A [OK]

Hint: Use raw + JSON in Postman for JSON body [OK]

Common Mistakes:

• Using form-data for JSON body
• Uploading JSON as binary
• Using x-www-form-urlencoded for JSON

3. Given this Postman request setup:

{
  "name": "Alice",
  "age": 30
}

and the header Content-Type: application/json, what will the API most likely do if it expects JSON?

medium

A. Return an error because the body is not JSON

B. Process the data correctly and respond successfully

C. Ignore the body and return default data

D. Crash due to unsupported format

Solution

1. Step 1: Check if body matches Content-Type

   The body is valid JSON and the header says application/json, so they match.

2. Step 2: Predict API behavior with matching format

   When the API receives matching JSON body and header, it processes the data as expected and responds successfully.

3. Final Answer:

   Process the data correctly and respond successfully -> Option B

4. Quick Check:

   Matching JSON body and header = C [OK]

Hint: Matching JSON body and header means success [OK]

Common Mistakes:

• Assuming error despite correct format
• Thinking API ignores body
• Believing API crashes on valid JSON

4. You send a POST request with body:

name=Bob&age=25

and header Content-Type: application/json. The API returns a 400 Bad Request error. What is the likely cause?

medium

A. The body format does not match the Content-Type header

B. The API URL is incorrect

C. The network connection failed

D. The API does not accept POST requests

Solution

1. Step 1: Analyze body and header mismatch

   The body is URL-encoded form data, but the header says JSON, so they don't match.

2. Step 2: Understand API response to mismatch

   APIs expecting JSON will reject mismatched body formats, causing 400 Bad Request errors.

3. Final Answer:

   The body format does not match the Content-Type header -> Option A

4. Quick Check:

   Mismatch body and header = 400 error = B [OK]

Hint: Check if body matches Content-Type to fix 400 errors [OK]

Common Mistakes:

• Blaming URL instead of body format
• Assuming network failure causes 400
• Thinking API rejects all POST requests

5. You need to send nested user data to an API that expects JSON. Which Postman setup ensures the body format matches API expectations?

{
  "user": {
    "name": "Eve",
    "details": {
      "age": 28,
      "city": "NY"
    }
  }
}

hard

A. Set body to raw, select JSON, and paste the nested JSON data

B. Set body to form-data and enter keys like user[name], user[details][age]

C. Set body to x-www-form-urlencoded and write nested JSON as plain text

D. Set body to binary and upload a text file with JSON

Solution

1. Step 1: Identify correct body type for nested JSON

   Nested JSON requires raw body type with JSON selected to preserve structure.

2. Step 2: Explain why other options fail

   Form-data and x-www-form-urlencoded flatten data and can't represent nested JSON properly. Binary is for files, not text data.

3. Final Answer:

   Set body to raw, select JSON, and paste the nested JSON data -> Option A

4. Quick Check:

   Raw + JSON for nested data = A [OK]

Hint: Use raw + JSON for nested JSON bodies in Postman [OK]

Common Mistakes:

• Using form-data for nested JSON
• Sending nested JSON as plain text in urlencoded
• Uploading JSON as binary file