온라인 JSONPath 쿼리 도구입니다. $.property를 통한 속성 접근, [n]을 통한 배열 인덱스, [*]를 통한 와일드카드, [start:end]를 통한 배열 슬라이싱, ?()를 통한 조건 필터링 표현식을 지원합니다. JSON과 경로를 입력하면 실시간으로 쿼리가 실행되며(400ms 디바운스), JSON 정형 뷰와 정렬 테이블 뷰 두 가지 모드를 전환할 수 있습니다. 자주 사용되는 8가지 경로 예제를 내장하고 있으며 JSON 구문 오류를 자동으로 수정할 수 있습니다. JSON 파일 업로드, 쿼리 결과 다운로드, 키보드 단축키 조작, 로컬 히스토리 자동 저장을 지원하며 좌우 패널 너비 조정, 글꼴 크기 전환도 가능합니다. 모든 파싱과 쿼리는 브라우저 내에서 완전히 로컬에서 실행되며 데이터는 절대 업로드되지 않습니다. QA 테스터의 API 어설션, 백엔드 개발자의 로그 필드 추출, 프론트엔드 개발자의 API 검증 작업에 최적입니다.
다음과 같은 실용적인 문법을 지원합니다: ①$.property 또는 ['property']로 객체 속성에 접근; ②[n]으로 인덱스를 통한 배열 요소 접근(n은 0부터 시작하며 [-1]은 마지막 요소를 의미); ③[*] 또는 .* 와일드카드로 배열의 모든 요소 또는 객체의 모든 속성 값과 매치; ④[start:end] 배열 슬라이싱으로 지정된 범위의 요소를 가져옴; ⑤?(@.field op value) 조건 필터링으로 ==/!=/>/</>=/<= 6가지 비교 연산자를 지원하며 문자열과 숫자 비교를 지원합니다.
?() 조건 필터링 표현식을 사용합니다. 예를 들어 $.store.book[?(@.price < 80)]은 가격이 80 미만인 책을 필터링하고, $.store.book[?(@.category == '프로그래밍')]은 카테고리가 프로그래밍인 책을 필터링합니다. 속성 이름 앞에는 @.를 붙여 현재 요소를 나타내야 하며 문자열 값은 작은따옴표 또는 큰따옴표로 감싸주세요.
[0]으로 첫 번째 요소, [-1]로 마지막 요소, [0:2]로 인덱스 0부터 1까지 첫 2개 요소를 가져옵니다(슬라이싱은 시작 위치를 포함하고 종료 위치를 포함하지 않는 반개구간입니다). 예를 들어 $.store.book[0:3]은 처음 3권의 책을 가져옵니다.
JSON 뷰는 표준 형식으로 들여쓰기된 JSON 결과를 표시하며 완전한 중첩 구조를 유지하므로 전체 데이터를 복사하거나 열람할 때 적합합니다. 테이블 뷰는 객체 배열 결과를 자동으로 속성 열별로 정렬하여 표시하여 Excel 테이블과 같은 표시가 되므로 여러 레코드를 열람할 때 더 직관적이며 전체 행의 필드 값 차이를 빠르게 비교할 수 있습니다. 단순형 결과도 키-값 쌍으로 정렬 표시됩니다.
입력한 JSON에 구문 오류(쉼표 누락, 따옴표 불일치, 불필요한 마지막 쉼표, 작은따옴표 사용 등)가 있는 경우 오류 위치가 빨간색으로 표시되고 '오류 복구' 버튼이 나타납니다. 클릭하면 일반적인 JSON 문제를 자동으로 복구합니다. Shift+Cmd/Ctrl+F로 먼저 정형화를 시도해볼 수도 있습니다. 정형화에서 오류가 발생하면 JSON에 문제가 있는 것이므로 복구 후 쿼리를 실행해 주세요.
다음을 확인해 주세요: ①JSON이 유효한지(정형화 버튼을 클릭하여 검증할 수 있습니다); ②JSONPath 경로의 철자가 정확한지, 속성 이름은 대소문자를 구분합니다; ③경로가 존재하는지(존재하지 않는 속성에 접근하면 오류가 발생합니다); ④필터링 표현식의 구문이 정확한지, 괄호와 따옴표가 일치하는지.
쿼리 상자 오른쪽에 있는 '예제' 버튼(아래쪽 화살표)을 클릭하면 드롭다운 메뉴에 8가지 자주 사용되는 경로 예제가 표시됩니다. 원하는 예제를 클릭하면 경로 표현식이 자동으로 입력됩니다. 먼저 '예제' 버튼을 클릭하여 샘플 JSON 데이터(서점 데이터)를 로드한 후 샘플 경로로 동작을 확인하는 것을 권장합니다.
모두 Shift+Cmd(Mac)/Shift+Ctrl(Windows) 조합 키를 사용합니다: Shift+Enter로 쿼리 실행, Shift+F로 JSON 정형화, Shift+O로 파일 업로드, Shift+D로 결과 다운로드, Shift+K로 모든 내용 초기화. 도움말 버튼(? 아이콘)에서 언제든지 전체 단축키 목록을 확인할 수 있습니다.
6가지 비교 연산자를 지원합니다: ==(같음), !=(같지 않음), >(보다 큼), <(보다 작음), >=(크거나 같음), <=(작거나 같음). 숫자 비교는 숫자 크기로 비교하고 문자열 비교는 사전순으로 비교합니다. 문자열 값은 작은따옴표 또는 큰따옴표로 감싸야 합니다.
필수는 아닙니다. 도구가 앞의 $.를 자동으로 완성해주므로 store.book[0]이라고 직접 입력해도 정상 동작합니다. 시스템이 자동으로 $.store.book[0]으로 정규화하여 실행합니다. 다만 표준 JSONPath 규약에서는 루트 노드를 나타내기 위해 $로 시작하는 것을 권장합니다.
도구는 최근 입력한 JSON을 브라우저 로컬 스토리지(localStorage)에 자동으로 저장합니다(최대 200건 히스토리). 다음에 페이지를 열 때 이전 내용을 자동으로 복원하므로 API 응답 결과를 매번 다시 붙여넣을 필요가 없습니다. 초기화 버튼(Shift+K)으로 현재 내용을 지울 수 있습니다.
네, 가능합니다. 툴바의 '업로드' 버튼을 클릭하거나 Shift+O를 눌러 로컬의 .json 또는 .txt 파일을 선택하면 파일 내용이 자동으로 읽혀 입력란에 설정됩니다. 쿼리 결과는 '다운로드' 버튼 또는 Shift+D로 query-result.json 파일로 로컬에 저장할 수 있습니다.
매우 적합합니다. API 디버깅 시 API 응답 JSON을 도구에 붙여넣고 JSONPath 표현식을 대화형으로 조정하여 쿼리 결과가 기대한 대로 나오는지 확인한 다음, 검증된 표현식을 Postman 테스트 스크립트, JMeter JSON Extractor, 자동화 테스트 프레임워크에 복사하여 사용할 수 있어 온라인 디버깅 시간을 크게 줄일 수 있습니다.
아니요. JSON 파싱, JSONPath 경로 매칭, 조건 필터링, 테이블 포맷팅은 모두 브라우저 내에서 JavaScript로 로컬 실행되며 입력한 JSON 내용이 네트워크를 통해 어떤 서버로도 전송되지 않습니다. 페이지를 닫은 후에는 로컬 localStorage에만 저장되며(초기화 가능), 민감한 비즈니스 데이터와 릴리스 전 API 데이터도 안심하고 사용할 수 있습니다.
네, 사용할 수 있습니다. [*]를 배열에 사용하면 배열의 모든 요소를 반환하고 객체에 사용하면(예: $.store.*) 객체의 모든 속성 값으로 이루어진 배열을 반환합니다. $.store.book[*].author처럼 속성과 조합하여 사용하면 배열 내 모든 요소의 author 속성을 추출하여 저자 목록을 만들 수 있습니다.
JSONPath는 JSON 문서에서 지정된 데이터를 추출하기 위한 경로 표현식 언어로, XML에 대한 XPath와 같은 역할을 합니다. API 개발과 테스트에서 API가 반환하는 JSON은 계층이 깊고 중첩이 많은 경우가 많아 수동으로 펼쳐서 계층을 따라 필드를 찾는 것은 비효율적이고 오류가 발생하기 쉽습니다. JSONPath를 사용하면 한 줄의 표현식으로 대상 데이터를 정확하게 찾아 추출할 수 있어 API 디버깅, 자동화 테스트, 데이터 추출 현장에서 개발자에게 필수적인 도구입니다.
JSONPath의 핵심 설계 사상은 경로 기호를 사용하여 데이터의 위치를 기술하는 것입니다: $는 루트 노드(전체 JSON 객체)를 나타내고, 점 . 또는 대괄호 []로 자식 속성에 접근하며, [n]으로 인덱스에 따라 배열 요소에 접근하고, [*]로 모든 요소와 매치하고, [start:end]로 배열의 일부를 잘라내고, ?()로 조건에 따라 배열 요소를 필터링합니다. 이 문법은 간결하지만 표현력이 높아 대다수의 데이터 추출 요구를 커버할 수 있습니다.
조건 필터링은 JSONPath의 가장 실용적인 기능 중 하나로 ?(@.필드 연산자 값) 형식으로 필터링 로직을 기술합니다. 예를 들어 ?(@.price < 100)은 price 필드가 100 미만인 배열 항목을 필터링하고 ?(@.status == 'active')는 status가 active인 레코드를 필터링합니다. @는 현재 순회 중인 배열 요소를 나타내며 @.field로 현재 요소의 특정 필드에 접근할 수 있어 조건 필터링이 매우 직관적입니다.
왜 코드 내에서 직접 디버깅하는 대신 전용 JSONPath 도구가 필요할까요? API 자동화 어설션이나 데이터 추출 코드를 작성할 때 JSONPath를 잘못 작성하면 API를 반복 실행하고 로그를 출력하며 코드를 수정하고 다시 실행해야 하므로 매우 비효율적입니다. 온라인 도구에서의 대화형 디버깅은 초 단위로 결과를 확인할 수 있고 표현식을 조정하면 즉시 피드백을 얻을 수 있어 정확한지 확인한 후 코드에 복사하면 디버깅 시간을 크게 절약할 수 있습니다.
테이블 뷰는 많은 유사 도구와 다른 본 도구의 실용적인 기능입니다: 쿼리 결과가 객체 배열인 경우(이는 가장 일반적인 API 응답 리스트 형식입니다), 모든 객체의 키를 자동으로 추출하여 헤더로 만들고 각 행의 데이터를 정렬하여 표시합니다. Excel 테이블과 같은 열람 경험으로 들여쓰기된 JSON 내에서 행별로 필드 값을 찾는 것보다 훨씬 직관적이며 여러 레코드의 필드 차이를 한눈에 비교할 수 있습니다.
JSON 오류 자동 복구도 실제 개발 현장을 고려하여 설계된 기능입니다: 로그, 문서, 채팅창에서 복사한 JSON에는 종종 작은따옴표가 사용되거나 쉼표가 누락되거나 마지막 항목에 불필요한 마지막 쉼표가 있거나 속성 이름에 따옴표가 없는 등 다양한 문제가 있습니다. 수동으로 복구하는 것은 번거롭지만 도구의 자동 복구 기능은 대부분의 흔한 JSON 형식 문제를 원클릭으로 처리할 수 있어 한 글자씩 오류를 찾을 필요가 없습니다.
로컬 히스토리는 고빈도 사용에 최적화된 세밀한 기능입니다: 개발자는 종종 동일한 API를 반복 디버깅하는데 도구를 열 때마다 JSON을 다시 붙여넣는 것은 번거롭습니다. 도구는 최근 입력을 브라우저 로컬 스토리지에 자동 저장하여 다음에 열 때 이전 내용을 자동으로 복원합니다. 200건의 히스토리면 일상 업무에 충분히 사용할 수 있습니다. 모든 데이터는 자신의 브라우저 내에만 존재하며 업로드되지 않습니다.
참고로 본 도구가 지원하는 것은 실용적인 핵심 JSONPath 문법 서브셋(속성 접근, 인덱스, 와일드카드, 슬라이싱, 조건 필터링)이며 일상 개발 현장의 90% 이상을 커버합니다. 재귀 하강(..), 스크립트 표현식, 다중 조건 조합 등 고급 문법은 현재 지원하지 않습니다. 이러한 고급 기능이 필요한 현장에서는 더 완전한 구현 라이브러리를 사용해야 할 수 있습니다. 대다수의 API 디버깅과 필드 추출 요구에는 현재 문법 세트로 충분히 대응할 수 있으며 더 가볍고 빠릅니다.
본 도구가 지원하는 모든 문법:
| 문법 | 설명 | 예시 결과(샘플 서점 JSON) |
|---|---|---|
$ | 루트 객체, 전체 JSON을 반환 | 완전한 store 객체 |
$.store.book[0] | book 배열의 첫 번째 요소에 접근(인덱스는 0부터 시작) | JavaScript 고급 프로그래밍 책 |
$.store.book[-1] | 배열의 마지막 요소에 접근 | 사용자 경험 요소 책 |
$.store.book[*] | 와일드카드, 배열의 모든 요소를 반환 | 전체 3권의 책으로 이루어진 배열 |
$.store.book[0:2] | 배열 슬라이싱, 인덱스 0부터 1까지 가져옴(반개구간) | 처음 2권의 책 |
$.store.book[*].author | 배열의 모든 요소의 author 필드를 추출 | ["김철수","이영희","박민수"] |
$.store.book[?(@.price < 80)] | 조건 필터링, price<80인 책을 추출 | Python과 UX 두 권(가격 79와 59) |
$.store.bicycle.color | 점 표기법으로 중첩된 객체의 속성에 접근 | "빨간색" |
?() 필터링 표현식에서 지원하는 연산자:
| 연산자 | 의미 | 예시 |
|---|---|---|
== | 같음(숫자와 문자열 지원) | ?(@.category == '프로그래밍') |
!= | 같지 않음 | ?(@.status != 'deleted') |
> | 보다 큼(숫자 비교) | ?(@.price > 100) |
< | 보다 작음 | ?(@.price < 50) |
>= | 크거나 같음 | ?(@.age >= 18) |
<= | 작거나 같음 | ?(@.count <= 100) |
모든 단축키는 Shift + Cmd(Mac)/Ctrl(Windows) 조합 키를 사용:
| 동작 | Mac 단축키 | Windows 단축키 |
|---|---|---|
| 쿼리 실행 | ⇧ + ⌘ + Enter | Shift + Ctrl + Enter |
| JSON 정형화 | ⇧ + ⌘ + F | Shift + Ctrl + F |
| 파일 업로드 | ⇧ + ⌘ + O | Shift + Ctrl + O |
| 결과 다운로드 | ⇧ + ⌘ + D | Shift + Ctrl + D |
| 내용 초기화 | ⇧ + ⌘ + K | Shift + Ctrl + K |
본 JSONPath 쿼리 도구의 JSON 파싱, 경로 매칭, 조건 필터링, 테이블 포맷팅 작업은 모두 브라우저 내에서 JavaScript로 완전히 로컬 실행됩니다. 입력한 JSON 데이터, 쿼리한 경로, 반환되는 결과가 어떤 서버에도 업로드되지 않으며 기록, 캐시, 클라우드 스토리지에 저장되지도 않습니다. 입력 히스토리는 브라우저 로컬 스토리지(localStorage)에만 저장되며(최대 200건), 초기화 버튼 또는 브라우저 데이터 삭제를 통해 제거할 수 있습니다. 민감한 비즈니스 필드, 릴리스 전 API 데이터, 운영 환경 로그가 포함되어 있어도 안심하고 사용할 수 있으며 데이터 유출 위험은 전혀 없습니다.
JSONPath 경로가 현재 JSON 내에서 해당 값을 찾을 수 없다는 의미입니다. 다음을 확인해 주세요: ①속성 이름의 철자와 대소문자가 정확한지(JSON은 대소문자를 구분합니다); ②중첩 계층이 정확한지, 중간 계층이 존재하는지; ③배열 인덱스가 범위를 벗어나지 않는지; ④정형화 버튼을 클릭하여 JSON 구조가 기대한 대로인지 확인해 주세요.
배열이 아닌 값에 [] 인덱스, [start:end] 슬라이싱, ?() 필터링을 사용하고 있다는 의미입니다. 이러한 작업은 배열에 대해서만 사용할 수 있습니다. 경로의 해당 위치가 실제로 배열인지 단일 객체인지 확인하고 먼저 $ 와일드카드나 루트 경로로 실제 구조를 확인해 주세요.
다음을 확인해 주세요: ①@ 뒤에 점이 있는지(@.field라고 작성해야 하며 점을 생략할 수 없습니다); ②문자열 값이 작은/큰따옴표로 감싸져 있는지(?(@.name == kimchulsu)는 올바르지 않으며 ?(@.name == 'kimchulsu')라고 작성해야 합니다); ③숫자에는 따옴표를 붙이지 마세요, 붙이면 문자열 비교가 됩니다; ④비교 연산자 양쪽에 불필요한 공백이 없는지.
JSONPath 표현식의 대괄호[] 또는 필터링 괄호()가 올바르게 짝지어지지 않았다는 의미입니다. 닫는 ] 또는 )가 작성되어 있는지 확인해 주세요. 특히 여러 대괄호가 중첩된 경우 각 [에 해당하는 ]가 있는지 확인해 주세요.
