JSON

Almost every time two pieces of software pass information to each other, it's written on the same little note card. That card is JSON, and you've been surrounded by it for years without looking.

JSON is the standard way software writes down structured information so other software can read it. Strip away the scary name and it's just labeled pairs: a name on the left, a value on the right, grouped together.

Here's what one looks like:

{
  "name": "Cat",
  "city": "Austin",
  "orders": 3
}

Read it like a note card. Name is "Cat." City is "Austin." Orders is 3. A human can read that at a glance, and so can every programming language on earth. That last part is the whole point. JSON is the closest thing software has to a common tongue, so a tool written in one language can hand a note card to a tool written in another and it just works.

You've already been on the receiving end of it constantly. When your AI orders something off an app's window and data comes back, it comes back as JSON nearly every time. The orders you pulled, the customer you looked up, the search results, the weather. All of it arrives on these little cards.

A couple of connections so it locks in:

• The schema is the blank form. JSON is one card filled out in that shape. Schema says what's allowed. JSON is the actual answer written down.
• Remember Markdown, the plain text formatted for humans to read? JSON is its sibling for machines. Both are just text with a few symbols. Markdown's symbols make things readable for a person. JSON's braces and quotes make things readable for a program.

Why a non-coder should care. The moment you peek behind any tool, export a file, look at what an API sent back, open a settings file, you'll see these curly braces. They look intimidating for about half a second, until you realize you're looking at a labeled list. And when an AI offers you "the data in JSON," it's saying "in the shape another tool can take without a human in the middle."

JSON is a note card of label-and-value pairs that every machine can read. Behind almost every app talking to another app, it's JSON on the wire.