무엇이 잘못되었는지 알려 주는 JSON 포매터
이 무료 JSON 포매터는 압축된 데이터로 가득한 내용을 읽기 쉽고 들여쓰기된 JSON으로 변환하는 동시에 유효성을 검사합니다. API 응답, 구성 파일 또는 로그 한 줄을 붙여넣으면 세 가지 기능을 한 번에 사용할 수 있습니다. 첫 번째 오류가 발생한 정확한 줄과 열을 알려 주는 JSON 검사기, 2칸·4칸 또는 탭 들여쓰기를 지원하는 JSON 가독화 도구, 그리고 다시 압축 버전이 필요할 때 사용하는 미니파이어입니다. 트리 보기, 키 정렬, JSON Schema 유효성 검사, JSON을 CSV로 변환하는 기능도 클릭 한 번이면 이용할 수 있습니다.
모든 작업은 브라우저에서 실행됩니다. 이 도구는 데이터를 서버로 전송하는 대신 자체적인 소형 파서를 사용하므로 오류를 쉬운 말로 설명할 수 있으며 토큰, 고객 기록 또는 내부 구성과 같은 비공개 데이터가 기기 밖으로 나가지 않습니다.
JSON 오류 메시지를 읽는 방법
대부분의 JSON 오류는 파서가 멈춘 위치가 아니라 그 바로 앞에서 발생합니다. 검사 도구가 다음과 같이 표시하면 3번째 줄, 9번째 열: "}" 앞의 후행 쉼표, 문제 문자 아래에 캐럿으로 해당 줄을 표시하므로 있어서는 안 되는 쉼표를 확인할 수 있습니다. 몇 가지 패턴만으로도 실제 사례의 대부분을 다룰 수 있습니다:
-
후행 쉼표. JavaScript에서는
[1, 2,]를 허용하지만 JSON에서는 허용하지 않습니다. 마지막 쉼표를 삭제하세요. -
작은따옴표 또는 따옴표 없는 키.
{name: 'Ann'}은 JSON이 아닌 JavaScript 객체입니다. 키와 문자열에는 큰따옴표가 필요합니다:{"name": "Ann"}. -
주석. JSON에는 주석이 없습니다. tsconfig.json과 같은 파일은 도구가 더 느슨한 형식을 사용하기 때문에 주석을 허용하지만, 엄격한 JSON 파서는
//및/* */를 거부합니다. -
쉼표 또는 대괄호 누락. 오류가 속성의 시작 부분에 나타난다면 그 바로 위 줄의 끝을 확인하세요. 오류가 "입력의 예상치 못한 끝"이라면 닫는
}또는]가 어딘가에 누락된 것입니다. -
Python 또는 JavaScript 값.
True,None,NaN및undefined는 JSON이 아닙니다.true,null또는 숫자를 사용하세요. -
곡선 따옴표. 워드 프로세서나 채팅 앱에서 복사한 텍스트에는
"와 거의 똑같아 보이는 인쇄용 따옴표가 포함된 경우가 많습니다.
"일반적인 실수 수정" 버튼은 주석, 작은따옴표, 따옴표 없는 키, 후행 쉼표, 곡선 따옴표 및 Python 스타일 값을 한 번에 수정하고 변경된 내용을 표시하므로 결과를 무작정 신뢰하지 않고 검토할 수 있습니다.
큰 숫자와 중복 키
JSON 자체에는 숫자 크기 제한이 없지만 JavaScript는 숫자를 64비트 부동 소수점으로 저장합니다. 다음과 같은 ID는 12345678901234567890 ~이 됩니다 12345678901234567000 정상적인 경우 이후 JSON.parse. 이 포매터는 작성한 그대로 모든 숫자를 유지하고, 값이 2^53을 초과하면 문자열로 전달해야 한다는 신호이므로 경고합니다. 중복 키도 표시합니다. JSON 표준은 중복 키를 금지하지 않지만, 대부분의 파서는 마지막 키만 조용히 유지하므로 오류가 숨겨질 수 있습니다.
JSON Schema 검증 한눈에 보기
JSON 검사기는 구문을 확인합니다. JSON Schema는 의미를 확인합니다. 어떤 필드가 필수인지, 각 필드의 유형이 무엇인지, 어떤 값이 허용되는지를 검사합니다. 간단한 스키마는 다음과 같습니다.
{"type": "object", "required": ["id", "email"],
"properties": {"id": {"type": "integer", "minimum": 1},
"email": {"type": "string", "format": "email"}}}
JSON Schema 탭은 draft 2020-12의 핵심 기능을 지원합니다. types, enum 및 const, 숫자 및 문자열 제한, pattern, 일반적인 형식(email, date, date-time, uri, uuid, ipv4, hostname), properties, required, additionalProperties, patternProperties, items 및 prefixItems, uniqueItems, contains, allOf, anyOf, oneOf, not, if/then/else 및 local을 지원합니다. $ref 다음으로 연결됩니다 $defs. 각 오류에는 다음과 같은 인스턴스 경로가 표시됩니다: $.users[1].email, 그리고 오류가 발생한 스키마 경로를 보여 줍니다. unevaluatedProperties처럼 도구가 평가하지 않는 키워드는 조용히 무시하는 대신 목록에 표시됩니다. 아직 스키마가 없다면 샘플 문서에서 초안을 생성한 뒤 직접 보완해 보세요.
전체 API의 스키마를 작성하는 일은 더 큰 작업입니다. 웹 페이지의 구조화된 데이터도 필요하다면 스키마 마크업 검사기가 검색 엔진용 JSON-LD를 검사해 줍니다. 이는 다른 종류의 스키마입니다.
JSON을 CSV로, CSV를 JSON으로 변환
스프레드시트에는 행과 열이 필요합니다. 변환기는 객체 배열을 받아 모든 키의 합집합을 헤더로 사용하고, 중첩 객체를 dot.notation 열로 평탄화하며, 배열은 하나의 셀에 JSON 텍스트로 유지합니다. =, + 또는 @로 시작하는 값에는 앞에 아포스트로피를 붙여 스프레드시트에서 수식으로 실행되지 않도록 합니다. 반대 방향으로는 헤더 행이 있는 CSV를 붙여 넣을 수 있습니다. 구분 기호가 자동으로 감지되고, 쉼표와 줄 바꿈이 포함된 인용 필드가 처리되며, 숫자와 true/false를 적절한 형식으로 변환할 수 있고, address.city 헤더는 다시 중첩 객체가 됩니다. 이 데이터를 생성하는 쿼리를 작성하려면 SQL 쿼리 빌더 또는 Excel 수식 생성기를 사용해 보세요.
매일 JSON을 다룰 때 유용한 팁
- 디버깅하기 전에 검증하세요. "API가 고장 났다"는 문의의 절반은 요청 본문에 쉼표 하나가 빠진 경우입니다.
- 두 문서를 비교하기 전에 키를 정렬하세요. 그러면 diff 도구가 순서가 바뀐 필드가 아니라 실제 변경 사항을 보여 줍니다.
- 전송할 때는 최소화하고, 사람이 읽을 때는 서식을 지정하세요. JSON에서 공백은 의미가 없으므로 두 버전 모두 동일한 데이터를 담습니다.
- 공유 포매터에 비밀 정보를 입력하지 마세요. 데이터를 업로드하는 온라인 도구는 토큰과 개인정보에 위험이 될 수 있지만, 이 도구는 아무것도 업로드하지 않습니다.
개발자와 팀을 위한 더 많은 무료 도구는 무료 AI 생성기 및 도구 페이지에서 확인할 수 있습니다. 여기에는 JSON을 사용하는 코드를 위한 테스트 케이스 생성기도 포함되어 있습니다.
자주 묻는 질문
이 JSON 포매터는 무료이며 개인정보를 보호하나요?
예. 회원 가입이나 제한 없이 무료로 사용할 수 있습니다. 서식 지정, 검증 및 변환은 일반 JavaScript를 사용해 브라우저에서 실행되므로 JSON이 서버에 업로드되거나, 기록되거나, 저장되지 않습니다.
JSON 포매터와 JSON 검증기의 차이점은 무엇인가요?
포매터(또는 뷰티파이어)는 JSON을 읽기 쉽게 만들기 위해 들여쓰기와 줄 바꿈을 추가합니다. 검증기는 텍스트가 JSON 규칙을 따르는지 확인하고 첫 번째 오류를 보고합니다. 이 도구는 두 작업을 동시에 수행하며 오류가 발생한 정확한 줄과 열을 알려 줍니다.
후행 쉼표나 작은따옴표 때문에 JSON이 실패하는 이유는 무엇인가요?
JSON은 JavaScript보다 더 엄격합니다. 마지막 항목 뒤의 쉼표, 작은따옴표로 묶은 문자열, 따옴표가 없는 키 또는 주석을 허용하지 않습니다. Fix common mistakes 버튼을 사용하면 이러한 문제를 자동으로 수정한 다음 변경 사항을 검토할 수 있습니다.
포매터가 숫자나 키 순서를 변경하나요?
아니요. 숫자는 JavaScript에서 저장할 수 있는 범위를 초과하는 ID를 포함해 작성된 그대로 유지되며, 키는 Sort keys A-Z를 켜지 않는 한 원래 순서를 유지합니다.
어떤 JSON Schema 버전을 지원하나요?
이 도구는 타입, required, properties, enum, 문자열 및 숫자 제한, 형식, items, prefixItems, allOf, anyOf, oneOf, not, if/then/else 및 로컬 $ref를 포함해 JSON Schema draft 2020-12의 핵심을 검증합니다. 평가하지 않는 키워드는 조용히 무시하지 않고 대신 목록으로 표시합니다.