|||

K-Wave Now

경험이 설계를 하는 AI 시대, 새로운 프로젝트 개발론
AdvertisementLeaderboard Ad
Back to Edition
Vibe Coding

json파일이란 무엇인가

K-
By Editorial TeamPublished 2026년 9월 25일

JSON은 JavaScript Object Notation의 줄임말입니다. 우리말로는 보통 '자바스크립트 객체 표기법'이라고 부릅니다

JSON이란 무엇인가?

비전문가를 위한 JSON 기초


1. JSON을 한마디로 말하면

JSON은 컴퓨터 프로그램끼리 데이터를 주고받기 위해 사용하는 데이터 형식입니다.

쉽게 말하면,

JSON = 데이터를 정해진 규칙에 따라 포장해서 전달하는 방법

이라고 생각하면 됩니다.

예를 들어 사람의 정보를 컴퓨터가 이해할 수 있도록 다음과 같이 표현할 수 있습니다.

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

2. JSON은 왜 필요한가?

사람은 다음과 같은 정보를 쉽게 이해할 수 있습니다.

이름: John
나이: 30
도시: Los Angeles

하지만 컴퓨터 프로그램끼리 데이터를 주고받을 때는 일정한 형식과 규칙이 필요합니다.

그래서 다음과 같이 데이터를 표현합니다.

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

이렇게 하면 다른 프로그램도 각각의 데이터를 쉽게 읽고 처리할 수 있습니다.


3. Key와 Value

JSON에서 가장 중요한 개념은 Key와 Value입니다.

"name": "John"

여기서:

  • Key = "name"

  • Value = "John"

즉,

"name"이라는 항목의 값이 "John"이다.

라는 의미입니다.

또 다른 예:

"age": 30
  • Key → age

  • Value → 30


4. JSON의 기본 구조

JSON에서 자주 사용하는 기호는 다음과 같습니다.

기호의미{ }하나의 데이터 묶음[ ]여러 데이터를 묶음:Key와 Value를 연결,데이터를 구분

예:

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

5. { } 중괄호

중괄호 { }는 하나의 데이터 묶음을 표현합니다.

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

위 데이터는 한 사람의 정보를 하나의 묶음으로 표현한 것입니다.


6. [ ] 대괄호

대괄호 [ ]는 여러 개의 데이터를 묶을 때 사용합니다.

예:

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

여러 사람의 정보를 표현할 수도 있습니다.

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

즉,

  • { } → 하나의 데이터

  • [ ] → 여러 데이터를 묶음

이라고 생각하면 쉽습니다.


7. JSON에는 어떤 데이터를 넣을 수 있을까?

JSON에는 여러 종류의 데이터를 넣을 수 있습니다.

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

예:

  • "John" → 문자

  • 30 → 숫자

  • 19.99 → 소수

  • true → 참/거짓


8. 회사 업무에서는 JSON을 어디에서 사용하는가?

JSON은 특히 API를 이용할 때 많이 사용됩니다.

예를 들어 회사의 ERP와 ShipStation이 연결되어 있다고 생각해봅시다.

ERP
 ↓
API
 ↓
ShipStation

ERP에서 주문 정보를 ShipStation으로 전달할 때 JSON 형식으로 데이터를 보낼 수 있습니다.

예:

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

ShipStation은 이 데이터를 받아서 주문을 처리할 수 있습니다.


9. API와 JSON의 관계

처음에는 API와 JSON이 헷갈릴 수 있습니다.

쉽게 비유하면:

API = 데이터를 전달하는 통로

JSON = 그 통로를 통해 전달하는 데이터

예:

ERP ─────── API ─────── ShipStation
              ↑
          JSON 데이터

즉,

API를 이용해서 JSON 형태의 데이터를 다른 프로그램으로 전달한다.

라고 이해하면 됩니다.


10. JSON을 "데이터 포장지"라고 생각하기

택배를 생각해봅시다.

상자 안에 상품을 넣고 다음과 같은 정보를 붙입니다.

받는 사람: John
상품: Keyboard
수량: 2

컴퓨터에서는 이런 정보를 JSON으로 포장할 수 있습니다.

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

따라서 JSON을 쉽게 이해하려면:

JSON은 컴퓨터가 이해할 수 있도록 데이터를 정리해서 포장하는 방법이다.

라고 생각하면 됩니다.


11. 실제 업무 예시

ERP → ShipStation

ERP에서 다음 주문 정보를 가지고 있다고 가정합니다.

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

이를 JSON으로 표현하면:

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

이 데이터를 API를 통해 ShipStation으로 전달할 수 있습니다.

반대로 ShipStation에서 배송 정보를 ERP로 보낼 수도 있습니다.

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

ERP는 이 정보를 이용하여 주문 상태와 Tracking Number를 업데이트할 수 있습니다.


12. 핵심 정리

JSON을 처음 접한다면 다음 내용만 기억해도 충분합니다.

JSON

데이터를 정해진 형식으로 표현하는 방법

Key

데이터 항목의 이름

Value

실제 데이터

{ }

하나의 데이터 묶음

[ ]

여러 데이터를 묶음

API

프로그램끼리 데이터를 주고받는 통로


한 문장으로 정리

JSON은 API 등을 통해 컴퓨터 프로그램끼리 데이터를 주고받을 때 사용하는 대표적인 데이터 형식입니다.

ERP
  ↓
 API
  ↓
 JSON
  ↓
다른 프로그램

JSON을 이해하면 API와 프로그램 간 데이터 연동을 이해하는 데 큰 도움이 됩니다.

추천 기사