Using JSON Schema for API Response Validation

Recently the author needed to monitor a set of HTTP interfaces and validate the returned JSON data. After learning about JSON Schema from a frontend expert, they applied it to the project with good results and share the experience here.

What is JSON Schema? JSON Schema is a collection of JSON vocabulary used to describe and validate JSON data formats. As of the article's writing, the specification has reached draft‑07. It provides a human‑readable way to define data structures, useful for client‑side validation or automated test verification.

How to obtain JSON Schema implementations? Most major languages (C/C++, Java, JavaScript, PHP, Python, Scala, Go, etc.) have libraries supporting various drafts of the specification, sufficient for typical API response validation needs.

JSON Schema usage includes describing basic JSON data types such as object, array, number, string, boolean, and null. Example JSON values:

{"name": "picotaro", "age": 38}

["apple", "pen", "pineapple"]

10086

3.1415926

"pen pineapple apple pen"

true

false

null

These types can be combined to form complex JSON structures, which can then be validated against a schema.

When validating an API response, instead of writing custom logic, a JSON Schema can be defined. For example, to validate a response matching the first object format, a corresponding schema is created.

Configuration keywords (based on draft‑04 for broader compatibility) include:

type : specifies the data type (string, array, number, integer, object, boolean, null).

required : lists required object properties.

properties : defines schemas for object members.

const : (draft‑07) enforces a constant value.

enum : restricts a value to a predefined set.

maxLength , minimum , maximum , etc.: impose numeric or string constraints.

minItems , maxItems , uniqueItems : control array characteristics.

additionalProperties : governs extra object properties.

dependencies : defines property dependencies.

items and additionalItems : describe array element schemas.

Each keyword is explained with its purpose and examples, illustrating how to compose a schema that precisely validates the desired JSON structure.

Conclusion – JSON Schema simplifies JSON data validation in API testing and monitoring scripts, making it easier to pinpoint format errors and improving testing efficiency.