JSON이란 무엇인가 — 개발자가 아닌 사람도 이해하는 기초 설명

JSON은 한 번 발견하면 어디에나 보이기 시작합니다. 설정 파일. API 응답. ChatGPT 플러그인. 구글 애널리틱스 내보내기. {"name": "김지훈", "age": 28} 같은 걸 보고 "이게 뭐지?" 했다면 그게 JSON입니다.

개발자가 아니어도 JSON을 이해할 수 있습니다. 쉽게 말하면 정보를 구조적으로 적어두는 방법입니다. 읽는 법을 한 번 익히면 기술 문서들이 훨씬 덜 낯설어집니다.

JSON이 실제로 어떻게 생겼나요?

한 사람에 대한 정보를 JSON으로 표현하면 이렇습니다:

{
  "이름": "김지훈",
  "나이": 28,
  "도시": "서울",
  "취미": ["자전거", "요리", "독서"],
  "재직중": true
}

각 정보는 키(이름, 나이, 도시)와 값이 쌍으로 구성됩니다. 값은 텍스트, 숫자, 참/거짓, 목록(배열), 또는 또 다른 키-값 쌍이 될 수 있습니다.

스마트스토어, 카페24 API 연동

쇼핑몰 플랫폼 API를 연동할 때 주문 정보, 상품 데이터, 재고가 JSON으로 전달됩니다. 개발자에게 요청할 때 "JSON 형태로 오는 데이터"가 무엇인지 알면 커뮤니케이션이 훨씬 쉬워집니다.

ChatGPT, Claude API 직접 사용

AI API를 직접 연결하거나 n8n, Zapier 같은 자동화 도구를 쓸 때 메시지 구조, 파라미터, 응답이 모두 JSON입니다. 이걸 읽을 줄 알면 직접 수정할 수 있습니다.

구글 애널리틱스, 광고 데이터 내보내기

GA4, 구글 광고, 메타 광고의 데이터를 외부 도구에서 분석할 때 JSON 형식으로 내보내는 경우가 많습니다. 구조를 이해하면 엑셀보다 더 세밀하게 데이터를 다룰 수 있습니다.

설정 파일 편집

VS Code의 settings.json, 크롬 익스텐션의 manifest.json, Node.js 프로젝트의 package.json이 모두 JSON입니다. 설정을 직접 수정할 때 구조를 알면 두렵지 않습니다.

API나 설정 파일에서 JSON이 깨지는 건 거의 항상 같은 이유입니다:

마지막 항목에 쉼표 남기기. {"a": 1, "b": 2,} — 닫는 중괄호 앞의 쉼표가 문제입니다. 줄을 지우다가 자주 남는 실수입니다.
작은따옴표 사용. {'name': 'John'} — JSON은 큰따옴표만 씁니다. 작은따옴표는 무효입니다.
주석 넣기. // 이건 메모는 JSON에서 허용되지 않습니다. 주석이 필요하다면 JSON5나 JSONC 형식을 알아보세요.
괄호 짝 안 맞음. {은 반드시 }로, [는 ]로 닫아야 합니다. 중첩 구조가 깊어질수록 놓치기 쉽습니다.

어디가 잘못됐는지 모르겠다면 JSON 포맷터에 붙여 넣어보세요. 몇 번째 줄에 오류가 있는지 바로 알려줍니다.

JSON이 표준이 되기 전에는 XML이 데이터 교환의 주류였습니다. 오래된 시스템이나 공공 API에서 아직 볼 수 있어요. 같은 정보를 두 형식으로 비교하면:

JSON

{
  "도시": "서울",
  "인구": 9720000
}

XML

<city>
  <name>서울</name>
  <pop>9720000</pop>
</city>

JSON이 더 짧고 읽기 쉽습니다. XML은 더 장황하지만 JSON이 지원하지 않는 속성이나 주석 같은 기능이 있습니다. 현대 웹 개발에서는 대부분 JSON이 기본입니다.