Contract testing in Rest API - Practice Problems & Coding Challenges

Challenge - 5 Problems

❓ Predict Output

intermediate

What is the output of this contract test simulation?

Consider a REST API contract test where the consumer expects a JSON response with a userId as an integer and userName as a string. The provider returns the following JSON:

{"userId": "123", "userName": "Alice"}

What will the contract test most likely report?

A Test fails due to missing userName key

B Test passes because the keys match

C Test fails due to type mismatch on userId

D Test passes because values are convertible

💡 Hint

Check the expected data types in the contract.

The contract expects userId as an integer, but the provider returns it as a string. This type mismatch causes the test to fail.

🧠 Conceptual

intermediate

Which statement best describes contract testing?

Choose the best description of contract testing in REST APIs.

A Testing the database schema behind the API

B Verifying that the API provider and consumer agree on request and response formats

C Load testing the API under heavy traffic

D Testing the UI of the API consumer application

💡 Hint

Think about what contract testing ensures between two systems.

Contract testing ensures that the API provider and consumer agree on the structure and data types of requests and responses.

🔧 Debug

advanced

Identify the cause of contract test failure

Given this contract test snippet for a REST API consumer:

expect(response).toHaveProperty('data.id');
expect(typeof response.data.id).toBe('number');
expect(response.data.name).toBeDefined();

The provider returns:

{"data": {"id": null, "name": "Bob"}}

Why does the contract test fail?

A Because <code>data.id</code> is null, not a number

B Because <code>data.name</code> is missing

C Because <code>data</code> key is missing

D Because the response is not JSON

💡 Hint

Check the expected type of data.id.

The test expects data.id to be a number, but the provider returns null, causing the failure.

📝 Syntax

advanced

Which option correctly defines a JSON schema for contract testing?

Choose the valid JSON schema snippet that requires id as an integer and name as a string in the response object.

A { "object": true, "props": { "id": { "type": "int" }, "name": { "type": "string" } }, "mandatory": ["id", "name"] }

B { "type": "object", "properties": { "id": "integer", "name": "string" }, "required": ["id", "name"] }

C { "type": "object", "fields": { "id": { "type": "int" }, "name": { "type": "str" } }, "required": ["id", "name"] }

D { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": ["id", "name"] }

💡 Hint

Look for correct JSON schema keywords and types.

Option D uses correct JSON schema keywords: type, properties, and required with proper types integer and string.

🚀 Application

expert

How many tests are needed to fully cover a contract with 3 optional and 2 required fields?

You have a REST API contract with 5 fields in the response: 2 are required and 3 are optional. To fully test all combinations of optional fields presence or absence along with required fields, how many distinct contract tests are needed?

A 8

B 5

C 10

D 32

💡 Hint

Think about combinations of optional fields only.

Each optional field can be present or absent independently, so 2^3 = 8 combinations. Required fields are always present, so total tests = 8.

Practice

1. What is the main purpose of contract testing in REST APIs?

easy

A. To check the API's user interface design

B. To test the speed of the API response

C. To ensure two systems agree on the data they exchange

D. To monitor server hardware performance

Solution

1. Step 1: Understand contract testing definition

   Contract testing checks if two systems agree on the data format and behavior during communication.

2. Step 2: Compare options to definition

   Only To ensure two systems agree on the data they exchange matches this purpose; others relate to speed, UI, or hardware, which are unrelated.

3. Final Answer:

   To ensure two systems agree on the data they exchange -> Option C

4. Quick Check:

   Contract testing = data agreement [OK]

Hint: Contract testing checks data agreement between systems [OK]

Common Mistakes:

• Confusing contract testing with performance testing
• Thinking contract testing checks UI or hardware
• Assuming contract testing is about security

2. Which of the following is the correct way to define a contract test for a REST API endpoint?

easy

A. Test the API's front-end layout on different browsers

B. Measure the time taken for the API to respond

C. Verify the API server's CPU usage during requests

D. Check if the API returns the expected status code and response body

Solution

1. Step 1: Identify contract test elements

   Contract tests verify the API response matches the agreed format, including status codes and body content.

2. Step 2: Match options to contract test definition

   Check if the API returns the expected status code and response body matches this exactly; others relate to performance, server metrics, or UI, which are not contract tests.

3. Final Answer:

   Check if the API returns the expected status code and response body -> Option D

4. Quick Check:

   Contract test = expected response check [OK]

Hint: Contract tests check expected status and response body [OK]

Common Mistakes:

• Confusing contract tests with performance or UI tests
• Ignoring response body content in contract tests
• Testing server hardware instead of API contract

3. Given this contract test snippet in JavaScript using Pact: <pre>provider.addInteraction({ state: 'user exists', uponReceiving: 'a request for user data', withRequest: { method: 'GET', path: '/user/123' }, willRespondWith: { status: 200, body: { id: 123, name: 'Alice' } } }); What will happen if the provider returns status 404 instead of 200 during the test?

medium

A. The test will pass because the body matches the contract

B. The test will fail because the status code doesn't match the contract

C. The test will ignore the status code and only check the path

D. The test will pass if the response time is fast enough

Solution

1. Step 1: Understand the contract test expectation

   The contract expects a 200 status code with a specific body when requesting '/user/123'.

2. Step 2: Analyze the provider's actual response

   The provider returns 404, which does not match the expected 200 status code.

3. Final Answer:

   The test will fail because the status code doesn't match the contract -> Option B

4. Quick Check:

   Status mismatch causes test failure [OK]

Hint: Mismatch in status code causes contract test failure [OK]

Common Mistakes:

• Assuming body match overrides status code mismatch
• Ignoring status code in contract tests
• Thinking response time affects contract test result

4. You wrote a contract test that expects a JSON response with a field email. The test fails because the provider returns emailAddress instead. What is the best way to fix this?

medium

A. Change the provider to return email as expected by the contract

B. Update the contract to expect emailAddress instead of email

C. Ignore the field mismatch and pass the test anyway

D. Remove the email field from the contract test

Solution

1. Step 1: Identify contract responsibility

   The contract defines the expected data format; the provider must follow it.

2. Step 2: Choose the correct fix

   Changing the provider to return email matches the contract, ensuring stable integration.

3. Final Answer:

   Change the provider to return email as expected by the contract -> Option A

4. Quick Check:

   Provider must match contract fields [OK]

Hint: Provider must match contract fields exactly [OK]

Common Mistakes:

• Ignoring field name mismatches
• Changing contract to fit provider without agreement
• Removing important fields from contract

5. You have two microservices: Service A (consumer) and Service B (provider). Service A expects Service B's API to return a list of products with fields id, name, and price. You want to write a contract test that allows price to be optional (sometimes missing). Which approach best achieves this?

hard

A. Define the contract so price is optional using a matcher that allows missing fields

B. Require price always in the contract and fail if missing

C. Remove price from the contract entirely

D. Ignore the contract and test only after deployment

Solution

1. Step 1: Understand optional fields in contract testing

   Contract tests can use matchers to allow fields to be optional or have flexible types.

2. Step 2: Choose the approach that supports optional price

   Defining price as optional with a matcher allows the provider to omit it without failing the test.

3. Final Answer:

   Define the contract so price is optional using a matcher that allows missing fields -> Option A

4. Quick Check:

   Use matchers for optional fields in contracts [OK]

Hint: Use matchers to allow optional fields in contract tests [OK]

Common Mistakes:

• Forcing optional fields to be always present
• Removing important fields from contract
• Skipping contract tests and testing only post-deployment