데이터 주고받는 서식(JSON)

쉽게 말하면

읽는 법은 "제이슨"이에요. 이름은 어렵게 들리지만 정체는 그냥 양식이에요. 팩스로 주문서를 주고받던 시절에 거래처끼리 양식을 맞췄던 것처럼, 프로그램끼리도 데이터를 주고받으려면 양식부터 맞춰야 해요. 전 세계가 이 양식 하나로 거의 통일했어요. 그래서 결제사든 배달 플랫폼이든 AI든, 연동 설명서를 열면 전부 이 중괄호가 나와요.

이 표 하나만 기억하셔도 절반은 끝났어요. 엑셀에서 머리글을 정해 두고 그 밑에 줄줄이 채우듯, JSON도 이름과 내용의 짝을 중괄호에 담는 것뿐이에요.

진짜로 어떻게 생겼나

카페 주문 한 건을 엑셀에 적으면 메뉴 칸에 "아메리카노", 수량 칸에 2, 포장 칸에 "예"라고 쓰겠죠. 같은 내용을 JSON으로 적으면 이렇게 돼요. { "menu": "아메리카노", "qty": 2, "takeout": true } 처음 보면 암호 같지만, 뜯어 보면 엑셀 한 줄과 똑같아요.

규칙은 세 개뿐이에요. 콜론(:)의 왼쪽은 머리글, 오른쪽은 내용이에요. 쉼표(,)가 칸과 칸을 나눠요. 그리고 글자는 반드시 따옴표로 싸요. 숫자와 true(예), false(아니오)는 따옴표 없이 그대로 써요. 이 세 규칙만 알면 어떤 중괄호 덩어리든 "아, 표 한 줄이구나" 하고 알아볼 수 있어요.

읽기 연습을 한 번만 해 볼게요. { "visits": 12, "vip": true, "memo": "얼음 적게" } 라는 덩어리를 받았다면, 방문 12회에 단골 등급이고 얼음을 적게 달라는 손님 기록 한 줄이에요. 처음엔 낯설어도 머리글과 내용의 짝으로 끊어 읽으면 엑셀 줄 읽듯 읽혀요. 여기서 좋은 소식 하나요. 이 규칙을 지키며 직접 쓰는 건 사장님 일이 아니에요. 쓰는 건 AI와 프로그램이 해요. 사장님은 중괄호를 만났을 때 겁내지 않고 알아보기만 하면 돼요.

어디서 만나게 되나

JSON은 사장님이 찾아가서 만나는 게 아니라, 어느 날 갑자기 나타나요. 나타나는 자리는 정해져 있어요.

네 곳의 공통점이 보이시나요. 전부 사람 읽으라고 나온 게 아니에요. 프로그램끼리 주고받으라고 있는 것이 사장님 눈앞에 잠깐 노출된 것뿐이에요. 그러니 해석하려고 애쓰지 마시고, 그대로 복사해서 AI에게 건네는 게 정석이에요.

중괄호를 만났을 때, 순서대로

어디서 만났든 대처 순서는 똑같아요. 이 네 단계만 몸에 익히면 JSON 때문에 막히는 일은 없어요.

1. 1멈추지 않아요. 중괄호가 보였다고 잘못된 게 아니에요. 견본인지 에러인지부터 구분해요. 설명서 안에 있으면 견본, 빨간 글씨나 실패 화면과 함께 나오면 에러예요.
2. 2통째로 복사해요. 앞뒤를 자르거나 요약하지 말고, 중괄호가 시작하는 곳부터 끝나는 곳까지 전부요. 잘라낸 반쪽은 AI에게도 반쪽짜리 단서예요.
3. 3AI에게 상황과 함께 붙여넣어요. "결제사 설명서에 이런 게 있어" 또는 "저장 버튼을 눌렀더니 이게 떴어"처럼 언제 봤는지 한 줄만 붙이면 진단이 훨씬 빨라져요.
4. 4고쳐진 다음, 같은 동작을 한 번 더 해봐요. 에러였다면 재현이 안 되는지 확인하고, 견본이었다면 연동이 실제로 도는지 확인해요. 눈으로 확인해야 끝난 거예요.

보시면 알겠지만 네 단계 어디에도 "JSON 문법을 공부한다"가 없어요. 사장님의 일은 증거를 온전히 전달하는 것이고, 해석과 수리는 AI의 일이에요. 이 분업이 정확하면 연동도 에러도 무섭지 않아요.

사장님이 실제로 겪는 장면

증상이 보이면, AI에게 이렇게 말해요

외우실 것 없어요. 증상이 나타나면 이 표로 돌아와서 오른쪽 문장을 복사해 가세요. 어떤 경우든 에러 원문을 함께 붙여넣는 것이 핵심이에요.

지금은 신경 쓰지 않아도 되는 때

바이브캠퍼스 안에서 앱이나 사이트를 만들고 있는 동안에는 JSON을 몰라도 아무 지장이 없어요. 사장님이 말로 주문하면 AI가 코드를 쓰고, 그 코드가 데이터를 JSON으로 담고 푸는 것까지 알아서 해요. 주방에서 어떤 그릇에 재료를 옮겨 담는지 손님이 몰라도 되는 것과 같아요.

이 문서가 필요해지는 순간은 딱 세 가지예요. 외부 서비스를 연동할 때(결제사·예약·배달 설명서에 중괄호가 나와요), 에러 메시지에 JSON이라는 단어가 등장할 때, 그리고 데이터를 내보내거나 이사할 때(.json 파일을 받게 돼요). 그전까지는 이 문서를 닫아 두셔도 돼요. 손님 명단이 실제로 어디에 쌓이는지가 궁금한 거라면 그건 데이터베이스 이야기라서, 그 문서가 맞아요.

자주 묻는 것

Q. 엑셀 파일을 그대로 주고받으면 안 되나요?

엑셀은 사람용이에요. 서식·색깔·수식까지 딸려 있어서 무겁고, 여는 프로그램마다 해석이 조금씩 달라요. JSON은 내용만 남긴 기계용 양식이라 가볍고, 어디서 열든 똑같이 읽혀요. 사람이 볼 표는 엑셀, 프로그램이 주고받을 데이터는 JSON이라고 나누면 정확해요.

Q. .json 파일을 받았는데 열어 봐도 되나요?

네, 메모장으로 열어도 안전해요. 실행되는 프로그램이 아니라 그냥 글자예요. 다만 열어서 실수로 글자를 지우고 저장하면 양식이 깨져서 못 쓰게 될 수 있으니, 보기만 하고 고치지는 마세요.

Q. true, false, null 같은 영어는 뭔가요?

값 자리에 오는 세 가지 약속어예요. true는 "예", false는 "아니오", null은 "비어 있음"이에요. 포장 여부 칸에 true가 있으면 포장 주문이라는 뜻이에요.

Q. 따옴표가 왜 이렇게 많아요?

기계에게 "여기부터 여기까지가 글자"라고 표시해 주는 거예요. 사람은 문맥으로 알지만 기계는 표시가 없으면 몰라요. 따옴표가 하나라도 빠지면 그래서 전체가 안 읽혀요.

Q. CSV라는 것도 있던데 뭐가 다른가요?

CSV는 쉼표로만 칸을 나눈 더 단순한 표 양식이고, 엑셀에서 바로 열려요. 명단이나 매출표처럼 표 전체를 옮길 때는 CSV가 편하고, 프로그램끼리 실시간으로 주고받을 때는 JSON을 써요. 둘 다 "표를 글자로 담는 방법"이라는 점은 같아요.

Q. AI가 만든 코드에서 JSON 에러가 났어요. 제가 뭘 잘못한 건가요?

아니에요. 이 에러의 대부분은 서버가 약속과 다른 걸 보냈거나, 설명서와 실제 응답의 머리글 이름이 달라서 생겨요. 사장님 잘못이 아니라 양쪽 프로그램 사이의 약속이 어긋난 거예요. 에러 원문을 AI에게 주면 어느 쪽이 약속을 어겼는지 찾아내요.

Q. 중괄호 덩어리가 수백 줄인데 이걸 다 복사해요?

네, 길어도 통째로가 원칙이에요. AI는 긴 데이터를 읽는 데 강해요. 다만 그 안에 손님 전화번호나 카드 정보 같은 실제 개인정보가 섞여 있으면, 그 값들만 별표(***)로 가리고 붙여넣는 게 안전해요. 구조만 있으면 진단에는 충분해요.

Q. 손님 정보가 든 JSON 파일은 어떻게 다뤄야 하나요?

종이 명부와 똑같이 취급하세요. 카톡방·이메일에 함부로 올리지 않고, 안 쓰게 되면 지워요. 얼마나 보관해도 되는지는 정보 종류마다 법이 달라서 여기서 단정하지 않을게요. 개인정보보호위원회의 개인정보 포털 안내에서 확인하시는 게 정확해요. 개인정보 문서도 함께 보세요.