웹 개발이나 앱 개발을 시작하면 가장 자주 접하게 되는 데이터 형식이 바로 JSON(JavaScript Object Notation)입니다. 특히 외부 API를 연동하거나 서버와 데이터를 주고받을 때 대부분 JSON 형식으로 데이터를 전달합니다. 하지만 API를 처음 사용하는 개발자들은 “응답(Response)은 받았는데 원하는 값만 어떻게 가져오지?”라는 고민을 하게 됩니다.
이때 필요한 개념이 바로 JSON 파싱(Parsing)입니다. 이번 글에서는 JSON 데이터 구조를 이해하고 API 응답 값을 원하는 형태로 가공하는 기본적인 방법을 쉽게 알아보겠습니다.
JSON이란 무엇인가?
JSON은 데이터를 키(Key)와 값(Value) 형태로 표현하는 경량 데이터 포맷입니다. 사람이 읽기 쉽고 대부분의 프로그래밍 언어에서 쉽게 처리할 수 있어 현재 가장 널리 사용되는 데이터 교환 방식입니다.
예를 들어 사용자 정보를 API로 요청하면 다음과 같은 JSON 응답을 받을 수 있습니다.
{
“id”: 1,
“name”: “kim”,
“age”: 28,
“email”: “king@example.com”
}
위 데이터를 보면 name이라는 키에는”kim”이라는 값이 저장되어 있습니다. 프로그램에서는 필요한 키를 찾아 해당 값을 가져와 사용할 수 있습니다.
JSON 데이터 구조 이해하기
JSON은 크게 두 가지 형태로 구성됩니다
1. 객체(Object)
중괄호 {} 로 표현하며 여러 개의 키와 값을 저장합니다.
{
“title”: “ChatGPT”,
“language”: “Korean”
}
객체는 하나의 정보를 묶어서 표현할 때 사용됩니다.
2. 배열(Array)
대괄호 []로 표현하며 여러개의 데이터를 순서대로 저장합니다.
[
“Apple”
“Banana”
“Orange”
]
동일한 종류의 데이터를 여러 개 저장할 때 사용됩니다.
3. 객체 안에 배열
실제 API에서는 가장 많이 등장하는 구조입니다.
{
“users”:[
{
“name”:”kim”,
“age”:30
}
{
“name”:”lee”
“age”:25
}
]
}
이처럼 객체 안에 배열이 있고, 배열 안에 다시 객체가 들어가는 형태가 일반적입니다.
parsing(파싱)이란?
파싱은 JSON 데이터를 프로그램에서 사용할 수 있도록 원하는 값만 꺼내는 과정입니다.
예를 들어 아래 JSON이 있다고 가정해보겠습니다.
{
“user”:{
“name”:”kim”,
“email”:”kim@test.com”
}
]
여기서 이름만 사용하고 싶다면
data[“user”][“name”]
과 같이 접근하면
kim
이라는 값만 가져올 수 있습니다.
즉, 전체 데이터를 읽는 것이 아니라 필요한 정보만 추출하는 작업이 바로 파싱입니다.
API 응답값에서 원하는 데이터 찾기
실제 API 응답은 생각보다 훨씬 길게 내려옵니다.
예를 들어 AI API 응답이라면
{
“id”:”abc123″
“choices”:[
{
“massage”:{
“content”:”안녕하세요.”
}
}
]
}
원하는 답변은 가장 안쪽에 있습니다.
data[“choices”][0][“message”][“content”]
이렇게 단계별로 접근하면
안녕하세요.
만 추출할 수 있습니다.
처음 API를 사용할 때 저는 전체 JSON을 하나하나 접어가며 구조를 확인하는 습관을 들였습니다. 이 과정을 반복하다 보니 어떤 API를 만나더라도 필요한 데이터의 위치를 빠르게 찾을 수 있었고, 자동화 작업 속도도 눈에 띄게 빨라졌습니다.
JSON 파싱이 필요한 분야
JSON 파싱은 다양한 개발 및 자동화 환경에서 활용됩니다.
- OpenAI API 활용
- Google Maps API
- 날씨 API
- 쇼핑몰 상품 API
- WordPress REST API
- Make, Zapier, n8n 자동화
- Python 데이터 처리
- JavaScript 웹 개발
API를 사용하는 대부분의 프로젝트에서는 JSON 파싱이 기본 기술이라고 볼 수 있습니다.
초보자가 자주 하는 실수
배열과 객체를 혼동한다
data[“users”][“name”]
처럼 작성하면 오류가 발생할 수 있습니다.
배열이라면 먼저 인덱스를 지정해야 합니다.
data[“users”][0][“name”]
키 이름을 정확히 입력하지 않는다
JSON은 키 이름이 정확히 일치해야 합니다.
“name”
과
“kim”
은 서로 다른 키로 인식됩니다.
데이터 구조를 확인하지 않는다
API 문서를 읽지 않고 바로 코드를 작성하면 대부분 원하는 값을 찾지 못합니다. 먼저 JSON 전체 구조를 확인한 뒤 필요한 경로를 찾는 습관이 중요합니다.
JSON 파싱을 잘하는 팁
처음에는 JSON이 복잡하게 느껴질 수 있지만 다음 순서대로 접근하면 어렵지 않습니다.
- JSON 전체 구조를 먼저 확인한다.
- 객체와 배열을 구분한다.
- 원하는 데이터의 위치를 찾는다.
- 한 단계씩 접근하여 값을 추출한다.
- API 문서를 함께 참고한다.
이 과정을 반복하면 새로운 API를 접하더라도 훨씬 빠르게 데이터를 활용할 수 있습니다.
마무리
JSON은 오늘날 거의 모든 API에서 사용하는 표준 데이터 형식이며, 파싱은 그 데이터를 실제 프로그램에서 활용하기 위한 핵심 과정입니다. 처음에는 중첩된 구조 때문에 어렵게 느껴질 수 있지만, 객체와 배열의 차이를 이해하고 하나씩 접근하는 연습을 반복하면 금세 익숙해집니다.
저 역시 API 자동화를 시작했을 때는 긴 JSON 응답을 보는 것만으로도 부담스러웠지만, 구조를 차근차근 분석하는 습관을 들인 이후에는 원하는 데이터만 추출해 블로그 자동 발행이나 다양한 자동화 작업에 활용할 수 있었습니다. JSON 파싱은 한 번 제대로 익혀두면 Python, JavaScript, REST API 등 다양한 개발 환경에서 계속 활용되는 중요한 기초 기술이므로, 이번 기회에 기본 개념을 확실히 익혀두시길 바랍니다.