JSON 사용법은 웹 개발과 API 연동을 시작하는 분이라면 가장 먼저 익혀야 할 기본기입니다. JSON은 데이터를 주고받을 때 쓰이는 표준 형식으로, 서버와 클라이언트가 서로 정보를 교환하는 거의 모든 곳에서 쓰입니다. 이 글에서는 JSON의 구조부터 실제 작성 방법, 그리고 초보자가 자주 빠지는 함정까지 단계별로 살펴보겠습니다.
JSON이란 무엇이고 왜 쓰일까
JSON은 JavaScript Object Notation의 약자로, 사람이 읽기 쉽고 기계가 파싱하기도 쉬운 텍스트 기반 데이터 형식입니다. 이름에 JavaScript가 들어가지만 특정 언어에 종속되지 않으며, 파이썬, 자바, PHP 등 거의 모든 프로그래밍 언어가 JSON을 지원합니다.
과거에는 XML이 데이터 교환의 표준이었지만, JSON은 더 가볍고 간결하다는 장점 때문에 현재 웹 API의 사실상 표준으로 자리 잡았습니다. 예를 들어 날씨 정보, 지도 데이터, 결제 응답값 등 외부 서비스에서 받아오는 데이터 대부분이 JSON 형태로 전달됩니다.
JSON 기본 문법과 데이터 타입
JSON의 구조는 두 가지 핵심 형태로 이루어집니다. 하나는 중괄호로 묶는 객체(object)이고, 다른 하나는 대괄호로 묶는 배열(array)입니다. 객체는 키와 값의 쌍으로 구성되며, 키는 반드시 큰따옴표로 감싸야 합니다.
아래는 가장 기본적인 JSON 예시입니다.
{
"name": "홍길동",
"age": 30,
"isMember": true,
"hobbies": ["독서", "코딩"],
"address": null
}JSON에서 사용할 수 있는 값의 종류는 정해져 있습니다. 다음 표로 정리해 보겠습니다.
| 데이터 타입 | 표기 방법 | 예시 |
|---|---|---|
| 문자열(String) | 큰따옴표로 감싸기 | "안녕하세요" |
| 숫자(Number) | 따옴표 없이 그대로 | 42, 3.14 |
| 불리언(Boolean) | 소문자 사용 | true, false |
| 배열(Array) | 대괄호로 나열 | [1, 2, 3] |
| 객체(Object) | 중괄호로 키-값 쌍 | {"a": 1} |
| 널(Null) | 소문자 null | null |
실전에서 JSON을 다루는 방법
이론을 알았다면 이제 실제로 JSON을 어떻게 활용하는지 살펴보겠습니다. 대부분의 프로그래밍 언어는 JSON 문자열을 프로그램에서 다룰 수 있는 형태로 변환하거나, 반대로 변환하는 기능을 기본 제공합니다.
- JSON 문자열을 객체로 변환하는 과정을 파싱(parsing)이라고 부릅니다. 자바스크립트에서는 JSON.parse() 함수를 사용합니다.
- 반대로 객체를 JSON 문자열로 만드는 과정을 직렬화(serialization)라고 하며, JSON.stringify()를 사용합니다.
- API 요청을 보낼 때는 보통 객체를 직렬화해서 전송하고, 응답을 받을 때는 파싱해서 사용합니다.
실무에서는 들여쓰기가 엉망인 한 줄짜리 JSON을 받아 구조를 파악해야 하는 경우가 많습니다. 이런 작업을 손으로 하면 시간이 오래 걸리고 실수도 잦은데, JSON 정렬기를 활용하면 복잡한 데이터를 보기 좋게 정돈하고 문법 오류까지 한 번에 확인할 수 있어 편리합니다.
초보자가 자주 하는 실수와 해결법
JSON은 문법이 단순한 만큼 작은 실수 하나로 전체 데이터가 무효가 되기 쉽습니다. 가장 흔한 실수들을 미리 알아두면 디버깅 시간을 크게 줄일 수 있습니다.
- 마지막 요소 뒤에 쉼표를 남기는 경우입니다. JSON에서는 마지막 항목 뒤에 쉼표를 붙이면 오류가 납니다.
- 주석을 다는 경우입니다. JSON 표준은 주석을 허용하지 않으므로 // 나 /* */ 를 넣으면 파싱에 실패합니다.
- 숫자나 불리언 값을 따옴표로 감싸는 경우입니다. "30"은 문자열이고 30은 숫자로, 둘은 전혀 다르게 처리됩니다.
오류를 줄이는 가장 확실한 방법은 작성 후 검증 도구로 한 번 확인하는 습관입니다. 데이터 양이 많아질수록 사람 눈으로 모든 괄호의 짝을 맞추기는 어렵기 때문에, 자동 검증 기능을 적극 활용하는 것이 안전합니다. JSON 사용법의 기본기를 탄탄히 다지고 이런 도구를 함께 쓴다면, 어떤 API를 만나더라도 데이터를 자신 있게 다룰 수 있습니다.