[마스터] 자동화 시스템의 혈관, JSON을 모르면 파이프라인은 반드시 터진다

결론. JSON은 데이터가 아니라 ‘구조’에 대한 약속이다.

자동화의 끝은 결국 API 연동이다. 그리고 그 API라는 파이프라인 속을 흐르는 피가 바로 JSON이다. 이걸 단순한 텍스트 쪼가리로 보는 순간, 당신의 자동화 시스템은 동맥경화로 막혀버린다. 결론부터 말하면, JSON은 단순한 데이터 포맷이 아니다. 이건 현대 분산 시스템의 아키텍처를 지탱하는 언어적 약속(Protocol), 즉 ‘구조’ 그 자체다.

API 통신, 왜 하필 JSON인가?

옛날에는 XML이라는 놈이 있었다. 시작 태그, 끝 태그… 인간이 보기엔 친절했지만 기계에겐 수다쟁이일 뿐. 데이터를 10만큼 보내는데 포장지가 50인 격이었다. 무겁고, 파싱(해석)하는 데 드는 비용도 컸다.

XML 예시:
<user>
<name>pipe-master</name>
<level>20</level>
</user>

JSON 예시:
{ “user”: { “name”: “pipe-master”, “level”: 20 } }

차이가 보이나? JSON은 군더더기를 싹 뺐다. ‘키:값’이라는 극도로 단순한 구조로 기계가 이해하기 가장 빠른 형태를 갖췄다. 서버가 클라이언트에게 데이터를 던져줄 때, 알맹이만 JSON에 담아 던지니 빠를 수밖에. 자동화에서 속도는 생명이다.

진짜 이유는 ‘직렬화(Serialization)’에 있다.

정말 깔끔하게 정리된 대학생 리포트 수준으로, 좀 더 깊게 들어가 보자. 진짜 핵심은 ‘직렬화’와 ‘역직렬화’ 개념에 있다.

파이썬에서 만든 객체(Object)나 딕셔너리(Dictionary) 데이터를 네트워크 너머 자바(Java) 시스템으로 어떻게 보낼 건가? 둘은 사용하는 언어와 메모리 구조가 완전히 다르다. 이럴 때 필요한 게 ‘공용어’다. 모든 언어의 데이터 구조를 ‘하나의 표준 텍스트 형식’으로 변환해주는 작업, 이게 바로 직렬화다. 그리고 JSON이 바로 그 표준 텍스트 형식의 왕이다.

• 직렬화 (Serialization): 내 프로그램 속 복잡한 데이터 객체 → 네트워크로 전송 가능한 JSON 문자열로 변환. (택배 상자에 물건을 담아 포장하는 과정)
• 역직렬화 (Deserialization): 전송받은 JSON 문자열 → 상대방 프로그램이 이해할 수 있는 데이터 객체로 복원. (택배 상자를 열어 물건을 꺼내 조립하는 과정)

JSON을 모른다는 건, 택배 상자 포장법과 개봉법을 모르면서 해외 배송을 하겠다는 소리다. 내용물이 온전히 전달될 리가 없다.

실전에서 JSON 구조 모르면 벌어지는 일

나도 이걸로 2시간 날린 적 있다. API 문서만 보고 `response.data.user`를 찍었는데 계속 `undefined` 에러가 터졌다. 원인은 데이터 구조에 있었다.

내가 예상한 데이터:

{ “data”: { “user”: “pipe-master” } }

실제로 서버가 보낸 데이터:

{ “data”: [ { “user”: “pipe-master” } ] }

차이가 보이나? 데이터가 배열([ ]) 안에 객체({ })로 한 겹 더 감싸여 있었다. 올바른 접근은 `response.data[0].user`였다. 이 대괄호 하나, 중괄호 하나의 차이를 모르면 자동화는 첫 단추부터 망가진다. JSON 문법이 아니라, 서버와 클라이언트 간의 ‘데이터 구조 설계’를 읽는 눈이 필요한 거다.

Q. 그럼 JSON 공부는 어떻게 해야 하나?

A. 문법 책 펴볼 필요 없다. 그냥 구글이든 네이버든, 아무 API나 잡고 응답(Response) 값을 눈으로 계속 뜯어보는 게 최고의 공부다. 데이터가 객체로 시작하는지, 배열로 시작하는지. 내가 원하는 값이 몇 단계 깊이에 중첩(Nested)되어 있는지. 이걸 능숙하게 파악하는 순간, 어떤 API를 만나도 두렵지 않게 된다.

Q. JSON 말고 다른 대안은 없나?

A. 있다. Protocol Buffers(Protobuf)나 MessagePack 같은 것들. 이진(Binary) 기반이라 JSON보다 더 빠르고 가볍다. 하지만 이건 서버와 서버 간의 고성능 통신, 즉 내부자들끼리 쓰는 언어에 가깝다. 범용성, 그리고 인간의 가독성까지 고려하면 웹 기반 API 통신에서는 여전히 JSON이 압도적인 표준이다. 외부 시스템과 연동하는 자동화라면 99% JSON을 만난다고 보면 된다.

최종 정리.

자동화 시스템을 만든다는 건, 결국 수많은 독립된 서비스(Microservices)들을 API라는 파이프로 엮어 하나의 유기체처럼 움직이게 하는 작업이다. 이때 JSON은 각 장기(서비스)에 산소와 영양분(데이터)을 공급하는 혈액의 역할을 한다. 혈액의 성분과 구조를 모르는데 어떻게 시스템의 건강을 보장하겠나.

JSON을 다룬다는 건, 시스템의 신경망을 직접 만지는 것과 같다. 이걸 제어하는 자가 자동화 파이프라인의 흐름을 지배한다. 이건 선택이 아니라 생존의 문제다.

PipeMaster-Lab 운영정책 및 제보 안내