Workflow · 8 min read
How to Debug an API JSON Response
Most “the API is broken” incidents are a field that changed type, a field that went missing, or a null nobody expected.
JSON guides and references
Working notes on the parts of JSON that actually cause problems — parse errors, schema evolution, array diffing, type inference and the Excel behaviours that quietly corrupt a CSV export. Each article links to the tool that does the job.
- Workflow · 7 min read
How to Generate TypeScript from JSON
Generated types are inference from evidence. The quality of the output is entirely determined by the quality of the sample.
- Reference · 9 min read
JSON Schema Explained, From Sample to Contract
A generated schema describes the sample you gave it. A useful schema describes the agreement you actually want to enforce.
- Workflow · 7 min read
How to Convert JSON to CSV Without Losing Data
CSV is flat and JSON is a tree. Everything difficult about the conversion follows from that one sentence.
- Reference · 8 min read
JSONPath Explained, With Runnable Examples
JSONPath is XPath for JSON: a compact way to say “every email address in this document”, whatever shape it is in.
- Workflow · 7 min read
How to Compare Two JSON Files Properly
Reorder a few keys and `git diff` says every line changed. A structural diff says nothing changed — because nothing did.
- Comparison · 7 min read
JSON vs YAML: Which to Use and When
JSON for machines, YAML for humans — with a short list of YAML behaviours that have caused real outages.
- Fundamentals · 7 min read
How to Validate JSON: Syntax and Schema
“Unexpected token } in JSON at position 582” is a true statement and a useless one. Here is how to get from it to the actual problem.
- Workflow · 6 min read
How to Format JSON (and When Not To)
Formatting changes nothing but whitespace — which is exactly why choosing the right moment to do it matters.
- Fundamentals · 8 min read
What Is JSON? A Practical Guide for Developers
JSON is small enough that its entire grammar fits on one page — which is exactly why the edge cases catch people out.