API를 공부하기 시작하면 거의 반드시 보게 되는 단어가 있다. 바로 JSON이다.
처음에는 정말 낯설다. API를 요청했더니 화면에 이상한 괄호와 따옴표만 잔뜩 보인다.
{
"name": "Mary",
"age": 20
}
처음 보면 “이게 코드인가?”, “왜 이렇게 생겼지?”라는 생각이 든다. 나도 API를 처음 봤을 때는 화면에 영어와 괄호만 잔뜩 나와서 오류인 줄 알았다.
그런데 알고 보니, 이것은 오류가 아니라 컴퓨터끼리 정보를 주고받는 가장 흔한 방법이었다.
그리고 그 형식을 JSON이라고 부른다.
JSON은 무엇일까
JSON은 JavaScript Object Notation의 줄임말이다.
이름은 조금 어려워 보이지만, 쉽게 말하면 “정보를 정리해서 적는 방법”이다.
예를 들어 사람 한 명의 정보를 적는다고 해보자.
우리는 보통 이렇게 쓴다.
- 이름: Mary
- 나이: 20
- 사는 곳: Seoul
JSON으로는 이렇게 쓴다.
{
"name": "Mary",
"age": 20,
"city": "Seoul"
}
즉:
"name"→ 어떤 정보인지"Mary"→ 실제 값
처럼 이름과 값을 한 쌍으로 묶어서 적는다.
그래서 JSON은 사람이 보기에도 비교적 쉽고, 컴퓨터도 이해하기 쉬운 형식이다.
왜 API에서 JSON을 사용할까
API는 한 프로그램이 다른 프로그램에게 정보를 요청하는 기능이다.
예를 들어 날씨 API에 “서울의 날씨를 알려줘”라고 요청하면, API는 결과를 다시 보내준다.
그런데 컴퓨터는 그냥 “오늘 맑음!”처럼 보내면 이해하기 어렵다.
어떤 값이 온도인지, 어떤 값이 도시 이름인지 알 수 없기 때문이다.
그래서 API는 정보를 일정한 규칙으로 정리해서 보내는데, 그때 가장 많이 사용하는 형식이 JSON이다.
예를 들어 날씨 API는 이렇게 보낼 수 있다.
{
"city": "Seoul",
"temperature": 18,
"weather": "sunny"
}
그러면 프로그램은:
- 도시 = Seoul
- 온도 = 18
- 날씨 = sunny
라고 정확하게 이해할 수 있다.
즉, JSON은 API가 정보를 깔끔하게 전달하기 위해 사용하는 “공통 언어” 같은 것이다.
왜 괄호와 대괄호가 같이 나올까
JSON을 보다 보면 { }와 [ ]가 같이 나오는 경우가 많다.
처음에는 둘 다 비슷해 보여서 더 헷갈린다.
하지만 역할은 다르다.
{ }→ 하나의 정보 묶음[ ]→ 여러 개를 모아놓은 목록
예를 들어 학생 한 명이면:
{
"name": "Tom",
"age": 18
}
처럼 중괄호를 사용한다.
하지만 학생이 여러 명이면:
[
{ "name": "Tom" },
{ "name": "Jane" },
{ "name": "Mike" }
]
처럼 대괄호 안에 여러 개의 JSON이 들어간다.
즉, 중괄호는 “한 명”, 대괄호는 “여러 명”이라고 생각하면 이해하기 쉽다.
왜 JavaScript랑 이름이 비슷할까
JSON이라는 이름 안에는 JavaScript가 들어 있다.
그래서 처음에는 “JSON은 JavaScript에서만 쓰는 건가?”라고 생각하기 쉽다.
하지만 그렇지 않다.
JSON은 원래 JavaScript에서 시작됐지만, 지금은 거의 모든 언어에서 사용한다.
예를 들어:
- Python
- Java
- PHP
- Node.js
- React
모두 JSON을 사용할 수 있다.
왜냐하면 형식이 단순해서 어떤 언어든 쉽게 읽고 만들 수 있기 때문이다.
즉, 이름은 JavaScript처럼 보여도, 실제로는 거의 모든 프로그래밍 언어가 사용하는 공통 형식이다.
JSON은 어디에서 많이 볼까
JSON은 API에서 가장 많이 보이지만, 사실 그 외에도 정말 자주 사용된다.
예를 들어:
- 웹사이트 회원 정보 저장
- 설정 파일 저장
- 게임 데이터 저장
- 앱과 서버가 통신할 때
- React나 Node.js 프로젝트 설정
특히 React를 하다 보면 package.json이라는 파일을 보게 된다.
바로 그 파일도 JSON 형식이다.
예를 들어:
{
"name": "my-app",
"version": "1.0.0"
}
처럼 되어 있다.
즉, JSON은 API뿐 아니라 프로그래밍 전체에서 정말 자주 등장한다.
왜 JSON이 인기가 많을까
예전에는 XML이라는 형식을 많이 사용했다.
그런데 XML은 이렇게 생겼다.
<person>
<name>Mary</name>
<age>20</age>
</person>
처음 봐도 JSON보다 훨씬 길고 복잡해 보인다.
반면 JSON은:
{
"name": "Mary",
"age": 20
}
처럼 더 짧고 보기 쉽다.
그래서 요즘 대부분의 API는 XML 대신 JSON을 사용한다.
나도 처음에는 JSON이 너무 복잡해 보였다. 그런데 몇 번 보다 보니까 오히려 표처럼 정리되어 있어서 훨씬 읽기 쉽다는 걸 알게 됐다.
JSON을 읽을 때 가장 먼저 보면 좋은 것
처음 JSON을 보면 전부 다 읽으려고 해서 더 어렵게 느껴진다.
하지만 사실은 아래 순서로 보면 훨씬 쉽다.
- 중괄호인지 대괄호인지 먼저 보기
- 따옴표 안의 이름(name, age, city)을 보기
- 그 옆에 있는 실제 값을 보기
예를 들어:
{
"title": "Hello",
"views": 120
}
이면:
- title = Hello
- views = 120
라고 읽으면 된다.
즉, JSON은 생각보다 어려운 코드가 아니라, 정보를 이름과 값으로 정리해놓은 목록에 가깝다.
한 줄로 정리하면
JSON은 프로그램끼리 정보를 주고받기 위해 사용하는 형식이다.
특히 API에서는 정보를 깔끔하고 쉽게 전달하기 위해 JSON을 가장 많이 사용한다.
그래서 API를 공부하기 시작하면, 거의 반드시 JSON을 만나게 된다.