개발자 도구
JSON 정리와 오류 확인, 어디서부터 봐야 할까요?
한 줄로 붙은 JSON을 보기 좋게 정리하고, 쉼표·따옴표·괄호 오류를 빠르게 찾는 기준을 정리했습니다.
짧은 답변
JSON 정리는 한 줄로 뭉친 데이터를 들여쓰기와 줄바꿈으로 읽기 쉽게 만드는 작업입니다. JSON 오류는 대개 빠진 쉼표, 잘못된 따옴표, 닫히지 않은 중괄호나 대괄호에서 발생합니다. 포맷터로 먼저 구조를 정리한 뒤 오류 위치와 주변 키를 확인하면 빠르게 수정할 수 있습니다.
핵심 요약
- JSON은 키와 문자열에 큰따옴표를 사용해야 합니다.
- 마지막 항목 뒤의 쉼표는 오류가 될 수 있습니다.
- 중괄호와 대괄호가 짝을 이루는지 확인해야 합니다.
- 민감한 API 키나 토큰은 마스킹한 뒤 붙여넣는 것이 안전합니다.
JSON 정리는 무엇을 바꾸나요?
JSON 정리는 데이터의 의미를 바꾸는 작업이 아니라, 사람이 읽기 쉽도록 줄바꿈과 들여쓰기를 적용하는 작업입니다. 한 줄로 압축된 응답값도 정리하면 객체, 배열, 키와 값을 훨씬 쉽게 구분할 수 있습니다.
반대로 JSON 압축은 줄바꿈과 공백을 줄여 복사하거나 전송하기 쉽게 만드는 작업입니다.
| 작업 | 무엇을 하나요? | 언제 쓰나요? |
|---|---|---|
| 정리 | 들여쓰기와 줄바꿈 추가 | API 응답 구조 확인 |
| 검증 | 문법 오류 확인 | 배포 전 설정값 확인 |
| 압축 | 불필요한 공백 제거 | 작은 설정값 복사 |
| 복사 | 정리된 결과를 클립보드로 이동 | 문서나 이슈에 첨부 |
자주 나는 JSON 오류
JSON 오류는 복잡해 보여도 대부분 몇 가지 패턴에서 시작됩니다. 포맷터가 오류를 알려주면 그 줄 주변의 쉼표, 따옴표, 괄호를 먼저 확인하세요.
- 문자열에 작은따옴표를 사용함
- 키 이름에 따옴표가 없음
- 마지막 항목 뒤에 쉼표가 남아 있음
- 중괄호 또는 대괄호가 닫히지 않음
- 주석을 넣음
민감한 데이터는 어떻게 다뤄야 하나요?
JSON에는 API 키, 토큰, 이메일, 사용자 ID 같은 민감한 값이 들어갈 수 있습니다. 오류만 확인하려면 실제 값을 모두 붙여넣기보다 일부를 마스킹한 샘플로 바꿔서 확인하는 것이 좋습니다.
원클릭툴의 JSON 정리 도구는 브라우저에서 처리되도록 설계되어 있지만, 민감 정보는 애초에 노출하지 않는 습관이 가장 안전합니다.
| 데이터 | 권장 처리 | 예시 |
|---|---|---|
| API 키 | 마스킹 | sk-*** |
| 이메일 | 일부 숨김 | user***@example.com |
| 사용자 ID | 샘플 값으로 교체 | user_123 |
| 토큰 | 붙여넣지 않기 | 실제 토큰 제외 |
원클릭툴에서 확인하는 순서
JSON 정리 도구에 데이터를 붙여넣고 정리/검증 결과를 확인하세요. 오류가 있으면 메시지 주변을 수정한 뒤 다시 정리하면 됩니다.
- JSON 붙여넣기
- 정리 또는 검증 실행
- 오류 줄 주변 확인
- 따옴표·쉼표·괄호 수정
- 정리된 결과 복사
참고한 공식 자료
바로 실행하기
JSON 포맷터
JSON 검증, 들여쓰기, 압축을 즉시 처리