JSON Toolkit

Engineering Practice

Putting JSON into real systems: how to define API contracts, how to manage configuration and fixtures, how to handle version compatibility, and how to maintain test data.

6 articles

Articles in this category

Key Points for Designing JSON API Data Contracts

Six things are very hard to change once shipped: response envelopes, error formats, pagination shape, representation of IDs and time, the semantics of null versus absent, and version evolution.

Intermediate~13 min readUpdated 2026-10-30

Managing JSON for Configuration, Fixtures, and Local Data

Configuration must be layered and validated; fixtures must be deterministic, readable, and diffable. If these two kinds of files are managed poorly, troubleshooting costs stay high for a long time.

Beginner~10 min readUpdated 2026-10-30

One JSON, Two Verdicts: Parser Differences and the Trust Boundary of Validation

When a validator accepts a document and the downstream service crashes, two parsers have usually disagreed about the same text. This article tests duplicate keys, NUL bytes, invalid UTF-8, NaN and leading zeros against real runtimes, explains how CVE-2026-33948 turned parser disagreement into an attack surface, and shows how to assign a single arbiter to every boundary.

Advanced~6 min readUpdated 2026-11-11