JSON Schema
JSON Schema is a standard vocabulary and specification for describing, validating, and annotating the structure and constraints of JSON data.
Data-Oriented Programming: Reduce software complexity
JSON Schema is a language and vocabulary for describing constraints on JSON data and validating JSON instances against those constraints.
- How it is used
- Validates JSON-shaped data at system boundaries and clarifies function contracts during development.
- How deep it goes
- Descends from object and array schemas through composition, strictness, runtime ranges, patterns, formats, and function-argument validation.
- Examples
- Demonstrates book-search requests, database responses, Open Library responses, catalog data, UUIDs, dates, and function arguments.
- What you can do after
- Build it from scratch by defining schemas, composing constraints, validating data with Ajv, and interpreting validation failures.
Read how Data-Oriented Programming: Reduce software complexity explains JSON Schema →
The Design of Web APIs, Second Edition
A JSON Schema format is an annotation identifying an expected semantic representation for a value of a specified JSON data type.
- How it is used
- Uses JSON Schema to model API data in OpenAPI for design, documentation, mocking, testing, and deployment.
- How deep it goes
- Explains core types, properties, arrays, required members, references, formats, and precision keywords, while deferring advanced features and optimization.
- Examples
- Uses Product models, atomic properties, arrays of strings, path parameters, response headers, and constrained unexpected-error responses.
- What you can do after
- Apply it via OpenAPI to build reusable resource models and precise operation data contracts.
Read how The Design of Web APIs, Second Edition explains JSON Schema →
Kafka Streams in Action, Second Edition
JSON Schema is a vocabulary and specification for describing and validating the structure and constraints of JSON data.
- How it is used
- Defines JSON event contracts for Schema Registry-backed Kafka producers and consumers.
- How deep it goes
- Explains object properties, required fields, defaults, references, generation, and serializer configuration; defers full JSON Schema specification details.
- Examples
- Uses Avenger objects, a Company executives array referencing person.json, and a typed SimpleAvengerJson consumer configuration.
- What you can do after
- Apply it via Schema Registry and Kafka JSON Schema serializers to exchange typed or generic Java JSON records.
Read how Kafka Streams in Action, Second Edition explains JSON Schema →
Build an AI Agent (From Scratch)
JSON Schema is a standard for describing and validating the structure, types, allowed values, and required fields of JSON data.
- How it is used
- Defines structured tool inputs so an LLM can select and invoke functions with constrained arguments.
- How deep it goes
- Explains object types, properties, enums, and required fields, but stops short of broader schema validation internals.
- Examples
- Uses a calculator definition, arithmetic enum, multiplication request, parsed arguments, and returned result.
- What you can do after
- Build it from scratch by defining calculator parameters and processing the model's generated tool arguments.
Read how Build an AI Agent (From Scratch) explains JSON Schema →
Related concepts
- OpenAPI specificationused by · The OpenAPI Specification is a standard, machine-readable format for describing HTTP APIs, including their operations, inputs, outputs, data structures, and security requirements.
- Spectralused by · Spectral is an open-source linter that applies configurable rules to JSON, YAML, and structured API description documents.
- validationused by · The process of checking data, behavior, systems, models, or results against defined criteria to assess their correctness, suitability, or acceptability.
- schema registryused by · A schema registry is a service that stores, versions, and provides schemas for structured data, often validating compatibility between schema versions.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.