What is JSON?

A Beginner's Guide to JSON

1. What is JSON?

JSON is a data format used by computer programs to exchange information.

In simple terms:

JSON is a way of organizing and packaging data so that different programs can exchange and understand it.

For example, a person's information can be represented like this:

{
  "name": "John",
  "age": 30,
  "city": "Los Angeles"
}

2. Why Do We Need JSON?

People can easily understand information written like this:

Name: John
Age: 30
City: Los Angeles

However, when computer programs exchange information, they need a standard format and clear rules.

JSON provides a simple and structured way to represent that information.

{
  "name": "John",
  "age": 30,
  "city": "Los Angeles"
}

This makes it easier for another program to read and process the data.

3. Key and Value

The two most important concepts in JSON are Key and Value.

"name": "John"

In this example:

• Key = "name"

• Value = "John"

It means:

The value of the "name" field is "John".

Another example:

"age": 30

• Key → age

• Value → 30

4. Basic JSON Structure

Here are some of the most common symbols used in JSON:

SymbolMeaning{ }A single data object[ ]A collection/list of data:Separates a Key and a Value,Separates data items

Example:

{
  "name": "John",
  "age": 30,
  "city": "Los Angeles"
}

5. Curly Braces { }

Curly braces represent one data object or one group of information.

{
  "name": "John",
  "age": 30
}

This example represents one person's information.

6. Square Brackets [ ]

Square brackets are used to represent a list or collection of multiple items.

For example:

[
  "Apple",
  "Banana",
  "Orange"
]

We can also use them to represent multiple people.

[
  {
    "name": "John",
    "age": 30
  },
  {
    "name": "Anna",
    "age": 25
  },
  {
    "name": "Mike",
    "age": 40
  }
]

A simple way to remember this is:

• { } → One data object

• [ ] → A collection of multiple items

7. What Kind of Data Can JSON Contain?

JSON can contain different types of data.

{
  "name": "John",
  "age": 30,
  "price": 19.99,
  "isActive": true
}

For example:

• "John" → Text

• 30 → Number

• 19.99 → Decimal number

• true → True/False value

8. Where is JSON Used in Business?

JSON is commonly used when working with APIs.

For example, imagine that your company's ERP system is connected to ShipStation.

ERP
 ↓
API
 ↓
ShipStation

The ERP can send order information to ShipStation using JSON.

For example:

{
  "orderNumber": "10001",
  "customerName": "John",
  "product": "Keyboard",
  "quantity": 2,
  "price": 50
}

ShipStation can receive this information and process the order.

9. What is the Relationship Between API and JSON?

API and JSON can be confusing when you first encounter them.

A simple way to understand them is:

API = The communication channel

JSON = The data being sent through that channel

For example:

ERP ─────── API ─────── ShipStation
              ↑
          JSON data

In other words:

An API can be used to send JSON-formatted data from one program to another.

10. Think of JSON as a "Data Package"

Think about sending a package.

You put an item in a box and provide information such as:

Customer: John
Product: Keyboard
Quantity: 2

In the computer world, we can package the same information as JSON:

{
  "customer": "John",
  "product": "Keyboard",
  "quantity": 2
}

So an easy way to understand JSON is:

JSON is a way of organizing and packaging data so that computer programs can understand and exchange it.

11. A Real Business Example

ERP → ShipStation

Suppose the ERP has the following order information:

Order Number: 10001
Customer: John
Product: Keyboard
Quantity: 2

We can represent this information as JSON:

{
  "orderNumber": "10001",
  "customer": "John",
  "product": "Keyboard",
  "quantity": 2
}

The ERP can send this data to ShipStation through an API.

The process can also work in the opposite direction.

For example, ShipStation can send shipping information back to the ERP:

{
  "orderNumber": "10001",
  "trackingNumber": "123456789",
  "carrier": "UPS",
  "status": "shipped"
}

The ERP can use this information to update the order status and tracking number.

12. Key Takeaways

If you are new to JSON, remember these basic concepts:

JSON

A format for representing and exchanging data

Key

The name of a data field

Value

The actual data stored in that field

{ }

One data object

[ ]

A collection/list of data

API

A communication interface that allows programs to exchange data

One-Sentence Summary

JSON is a common data format used by computer programs to exchange information, often through APIs.

ERP
  ↓
 API
  ↓
 JSON
  ↓
Another Program

Understanding JSON is an important first step toward understanding APIs and system-to-system data integration.