JSON이란? 개발자가 자주 보는 데이터 구조 쉽게 이해하기

웹사이트를 만들거나 API를 사용하다 보면 가장 자주 보게 되는 데이터 형식이 바로 JSON입니다.
처음 개발을 공부할 때는 {}, [], :, , 같은 기호가 섞여 있어서 복잡해 보이지만, 구조만 이해하면 생각보다 어렵지 않습니다.

특히 요즘은 ChatGPT API, Gemini API, 날씨 API, 쿠팡 파트너스 API, 네이버 API처럼 외부 서비스를 연결할 때 대부분 JSON 데이터 구조를 사용합니다. 그래서 개발자가 아니더라도 웹사이트 운영자나 블로그 자동화 프로그램을 만드는 사람이라면 JSON 기본 개념은 알아두는 것이 좋습니다.

JSON이란?

JSON은 JavaScript Object Notation의 줄임말입니다.
직역하면 “자바스크립트 객체 표기법”이지만, 현재는 자바스크립트뿐만 아니라 Python, Java, C#, PHP 등 거의 모든 프로그래밍 언어에서 사용하는 대표적인 데이터 형식입니다.

쉽게 말하면 JSON은 데이터를 아래처럼 정리합니다.

{
  "name": "홍길동",
  "age": 30,
  "isDeveloper": true
}

위 예시는 사람 정보를 JSON으로 표현한 것입니다.

JSON은 사람이 읽기 쉽고, 프로그램도 처리하기 쉬워서 API 응답, 설정 파일, 데이터 저장 등에 많이 사용됩니다.

JSON 데이터 구조 쉽게 이해하기

JSON 데이터 구조에서 가장 중요한 개념은 key와 value입니다.

{
  "title": "JSON이란?",
  "category": "IT TIP",
  "views": 120
}

여기서 "title", "category", "views"는 key이고, "JSON이란?", "IT TIP", 120은 value입니다.

JSON에서 자주 사용하는 값 종류

JSON은 어디에 사용될까?

실제로 JSON은 정말 많은 곳에서 사용됩니다.

예를 들어 블로그 자동화 프로그램에서 상품 정보를 불러온다면 아래처럼 JSON 데이터 구조를 사용할 수 있습니다.

{
  "productName": "삼성 USB 메모리",
  "price": 36300,
  "imageUrl": "https://example.com/image.jpg",
  "productUrl": "https://example.com/product"
}

이렇게 저장해두면 프로그램에서 상품명, 가격, 이미지, 링크를 각각 꺼내서 HTML 글을 자동 생성할 수 있습니다.

JSON 사용 방법 Step-by-Step

1. 데이터를 key-value 형태로 정리하기

먼저 어떤 정보를 저장할지 정합니다.

{
  "siteName": "win-j.com",
  "type": "IT 블로그"
}

2. 여러 개의 데이터는 배열로 묶기

게시글 목록처럼 여러 개의 데이터가 있다면 배열을 사용합니다.

[
  {
    "title": "JSON이란?",
    "category": "T.I.P"
  },
  {
    "title": "API란?",
    "category": "T.I.P"
  }
]

3. 중첩 구조 사용하기

조금 더 복잡한 데이터는 객체 안에 객체를 넣을 수 있습니다.

{
  "post": {
    "title": "JSON이란?",
    "author": "win-j"
  },
  "tags": ["JSON", "API", "개발자"]
}

4. JSON Formatter로 구조 확인하기

JSON 데이터 구조가 길어지면 눈으로 확인하기 어렵습니다.
이럴 때는 JSON Formatter나 JSON Pretty 도구를 사용하면 들여쓰기와 구조를 보기 쉽게 정리할 수 있습니다.

TIP

JSON 오류가 날 때는 먼저 쉼표 누락, 큰따옴표 누락, 중괄호 닫힘 여부를 확인하는 것이 가장 빠릅니다.

Python으로 JSON 다루기

Python에서는 json 모듈을 사용하면 JSON 데이터를 쉽게 처리할 수 있습니다.

JSON 문자열을 Python 딕셔너리로 변환

import json

json_text = '''
{
  "name": "win-j",
  "category": "IT TIP",
  "views": 100
}
'''

data = json.loads(json_text)

print(data["name"])
print(data["category"])

출력 결과는 다음과 같습니다.

win-j
IT TIP

Python 데이터를 JSON으로 변환

import json

data = {
    "title": "JSON이란?",
    "category": "T.I.P",
    "tags": ["JSON", "API", "개발"]
}

json_text = json.dumps(data, ensure_ascii=False, indent=2)

print(json_text)

ensure_ascii=False를 사용하면 한글이 깨지지 않고 표시됩니다.
indent=2는 JSON을 보기 좋게 들여쓰기 해주는 옵션입니다.

무료 vs 유료 JSON 도구 비교

JSON 자체는 무료 형식입니다.
다만 JSON을 보기 좋게 정리하거나 검증하는 도구는 무료 도구와 유료 도구로 나뉠 수 있습니다.

일반적인 블로그 운영자나 초보 개발자라면 무료 JSON Formatter만으로도 충분합니다.

실무에서는 Postman, Swagger, Insomnia 같은 API 도구와 함께 JSON을 자주 확인하게 됩니다.

JSON 핵심 개념 정리

JSON을 사용할 때 꼭 기억해야 할 핵심은 다음과 같습니다.

JSON 데이터 구조는 단순하지만, 중첩이 많아질수록 복잡해집니다.

그래서 실무에서는 JSON을 직접 눈으로만 확인하기보다 Formatter, Validator 같은 도구를 함께 사용하는 경우가 많습니다.

자주 발생하는 JSON 오류와 해결법

1. 문자열에 작은따옴표 사용

잘못된 예시:

{
  'name': 'win-j'
}

올바른 예시:

{
  "name": "win-j"
}

JSON에서는 반드시 큰따옴표를 사용해야 합니다.

2. 마지막 항목 뒤에 쉼표 사용

잘못된 예시:

{
  "name": "win-j",
  "type": "blog",
}

올바른 예시:

{
  "name": "win-j",
  "type": "blog"
}

마지막 항목 뒤에는 쉼표를 붙이면 안 됩니다.

3. 중괄호 또는 대괄호 닫기 누락

잘못된 예시:

{
  "title": "JSON이란?",
  "tags": ["JSON", "API"
}

올바른 예시:

{
  "title": "JSON이란?",
  "tags": ["JSON", "API"]
}

배열은 ], 객체는 }로 정확히 닫아야 합니다.

4. 숫자에 따옴표를 붙이는 경우

{
  "price": "36300"
}

이렇게 작성하면 숫자가 아니라 문자열로 인식됩니다.
계산이 필요한 값이라면 아래처럼 작성하는 것이 좋습니다.

{
  "price": 36300
}

실전 활용 팁

JSON은 단순히 개발 공부용 개념이 아니라 실제 작업에서 자주 사용됩니다.

API 응답 확인할 때

외부 API를 호출하면 대부분 JSON 형태로 결과가 옵니다.
예를 들어 날씨 API는 온도, 습도, 지역명 등을 JSON으로 전달합니다.

블로그 자동화에 활용할 때

상품명, 가격, 이미지 URL, 링크를 JSON 데이터 구조로 저장하면 자동으로 상품 소개글을 만들기 좋습니다.

사이트 설정값 저장할 때

다국어 문구, 테마 옵션, 메뉴 설정 등도 JSON 파일로 관리할 수 있습니다.

오류 찾을 때

JSON이 길어질수록 직접 찾기 어렵기 때문에 JSON Formatter로 정리한 뒤 오류 위치를 확인하는 것이 좋습니다.

TIP

개발 초보자라면 JSON을 외우려고 하기보다 “데이터를 정리하는 표준 형식”으로 이해하는 것이 좋습니다. API를 몇 번 사용해보면 자연스럽게 익숙해집니다.

JSON을 추천하는 대상

JSON은 아래와 같은 사람에게 특히 유용합니다.

• 웹 개발을 처음 배우는 사람

• Python, JavaScript, C#으로 프로그램을 만드는 사람

• API 연동을 공부하는 사람

• 블로그 자동화 프로그램을 만들고 싶은 사람

• 네이버 API, 쿠팡 API, AI API를 활용하려는 사람

• 데이터 구조를 쉽게 이해하고 싶은 초보자

실무 관점에서도 JSON은 반드시 익혀두는 것이 좋습니다.
프론트엔드, 백엔드, 모바일 앱, 자동화 프로그램, AI API 연동까지 거의 모든 분야에서 사용되기 때문입니다.

마무리

JSON이란 복잡한 개발 용어처럼 보이지만, 실제로는 데이터를 보기 좋게 정리하고 주고받기 위한 형식입니다.
처음에는 중괄호와 대괄호 때문에 어렵게 느껴질 수 있지만, key-value 구조만 이해하면 금방 익숙해집니다.

특히 API 연동, 블로그 자동화, 웹 개발, AI 서비스 활용을 생각하고 있다면 JSON 데이터 구조는 꼭 알아두는 것이 좋습니다.
처음부터 완벽하게 작성하려고 하기보다 간단한 예제를 직접 수정해보고, JSON Formatter로 확인하면서 익히는 것을 추천합니다.

win-j.com에서도 JSON Formatter, JSON Pretty, JSON Diff 같은 유틸리티를 함께 활용하면 JSON을 더 쉽게 확인하고 비교할 수 있습니다.