보기 좋게 바꾸기와 값으로 읽기는 다릅니다
응답 데이터의 들여쓰기만 바꾸려는데 고객번호가 달라졌다면, 숫자를 읽고 다시 쓰는 과정부터 확인하세요. 포매팅의 목적은 계층을 읽기 쉽게 만드는 것이고, 변환의 목적은 값을 다른 구조로 옮기는 것입니다. 파일 확장자가 같아도 두 과정이 원문을 보존하는 범위는 다릅니다.
ToolSites의 JSON Formatter는 숫자와 문자열 토큰을 계산하지 않고 원문대로 남깁니다. JSON 변환·비교·구조 보기는 값을 해석하므로 같은 보존 방식을 가정하면 안 됩니다. 먼저 필요한 것이 공백 정리인지, 필드와 값의 변환인지 정하세요.
큰 정수로 직접 확인하기
{"customerId":9007199254740993,"amount":1250}위 예제를 JSON Formatter에서 정리한 뒤 customerId의 마지막 숫자가 3인지 확인하세요. JavaScript의 일반 숫자로 JSON.parse 후 다시 직렬화하면 이 예제는 9007199254740992로 바뀔 수 있습니다. 2의53승을 넘는 정수 중에는 같은 숫자로 합쳐지는 값이 있기 때문입니다.
식별자는 크기를 계산할 값이 아니라면 문자열로 전달하는 편이 적합할 수 있습니다. 다만 API가 숫자를 요구한다면 임의로 따옴표를 붙이지 말고 계약을 확인하세요. 이 사이트의 변환 도구는 안전하게 표현하지 못하는 정수를 만나면 오류로 중단합니다. 오류를 없애려고 자릿수를 잘라내면 원래 의미를 잃습니다.
중복 키와 문자열의 함정
{"status":"draft","status":"published"}
{"message":"line 1\nline 2"}첫 문서에는 같은 status 키가 두 번 있습니다. 원문을 보존하는 Formatter는 두 키를 그대로 둘 수 있지만, 많은 값 파서는 뒤의 값만 남깁니다. 서로 다른 프로그램에서 결과가 달라질 수 있으므로 중복 키를 업무 데이터의 표현 방법으로 사용하지 마세요.
두 번째 문서의 역슬래시 n은 JSON 문자열 안의 줄바꿈 표현입니다. JSON 문서 전체를 문자열 한 개로 감싸는 stringify 작업을 하면 역슬래시와 따옴표가 한 번 더 이스케이프됩니다. 화면에서 역슬래시가 많아졌다고 즉시 삭제하지 말고, 문서인지 문서를 담은 문자열인지 먼저 확인하세요.
CSV를 옮길 때는 코드와 수량을 분리하세요
code,quantity
0017,20017은 상품 코드라면 앞자리0이 중요하고 수량2는 계산할 숫자일 수 있습니다. CSV 자체의 셀 표기만으로 업무 자료형이 정해지지는 않습니다. ToolSites의 CSV 변환은 셀을 문자열로 읽으므로 결과에서 code는 "0017", quantity도 "2"가 됩니다. 대상 프로그램이 숫자를 요구하는 필드만 명시적으로 바꾸세요.
전달 전 확인할 세 가지
- 원본의 복사본을 보관하고 대표 식별자·금액·null·빈 문자열을 결과와 비교합니다.
- 필드 개수·배열 순서·숫자/문자열 자료형을 확인합니다. 문법 통과는 API 필수 필드 검증과 다릅니다.
- 실제 데이터를 받는 프로그램에서 작은 샘플을 먼저 읽어 봅니다. 비밀 키와 개인정보는 공유용 예제에서 제거합니다.
근거와 적용 범위
ToolSites의 실제 처리 방식과 직접 작성한 예제를 기준으로 설명했습니다. 아래 자료는 형식·정의의 근거이며 이 사이트를 보증하거나 추천하는 자료는 아닙니다.