JSONPath 테스터 - JSON 값과 경로 추출

포맷팅브라우저에서 실행(업로드 없음)

RFC 9535 JSONPath로 API 응답과 중첩 JSON을 조회합니다. 데이터를 업로드하지 않고 일치한 경로를 확인하고 값만 복사할 수 있습니다.

다음에 할 작업

관련 작업 흐름을 이어가거나 이 작업 다음에 자주 사용하는 도구를 열어보세요.

이 도구 사용 방법

실제 API 응답, Webhook 본문, 로그 payload, JSON 테스트 fixture를 JSON 입력란에 붙여 넣습니다.

$.user.email, $.orders[*].id, $.orders[?(@.total >= 20)].id처럼 $로 시작하는 표현식을 입력합니다.

평가를 실행하고 JSON 오류가 나오면 경로를 바꾸기 전에 표시된 행과 열의 문법부터 수정합니다.

일치 개수와 정규화된 결과 경로를 확인해 배열, 필터, 중첩 필드가 의도한 노드를 선택했는지 검토합니다.

값 모음을 복사하거나 내려받아 테스트 fixture, 디버깅 기록, 문서 예시, 후속 데이터 작업에 사용합니다.

이 도구를 써야 할 때

API 응답 디버깅

실제 형태에 가까운 API 응답에서 값을 추출하고 정규화 경로까지 확인한 뒤 애플리케이션 코드에 표현식을 넣습니다.

Webhook 이벤트 검사

이벤트 배열을 상태, 유형, 금액 같은 필드로 걸러 Webhook 처리기에 필요한 식별자만 확인합니다.

테스트 fixture 값 준비

JSON fixture에서 고정 ID, 시간, 중첩 값을 뽑아 assertion, 매개변수 테스트, 회귀 사례에 사용합니다.

구조화 로그 로컬 검토

민감한 샘플을 업로드하지 않고 구조화 로그에서 요청 ID, 오류 코드, 사용자 필드, 반복 metadata를 조회합니다.

흔한 실수

잘못된 루트에서 시작하는 경우

모든 JSONPath 표현식은 루트를 뜻하는 $로 시작합니다. 애플리케이션 코드에서 복사한 경로가 $를 생략했거나 실제 응답에 없는 래퍼 객체를 전제로 하지 않았는지 확인하세요.

일치 결과 0개를 문법 오류로 보는 경우

필드가 없거나 배열이 비었거나 값이 null이거나 필터 조건이 거짓이면 올바른 표현식도 결과가 0개일 수 있습니다. 축약된 문서 예시뿐 아니라 실제 응답의 정규화 경로와 비교하세요.

중복 JSON 키를 무시하는 경우

같은 객체 키가 반복되면 JSON을 읽을 수 있더라도 결과가 모호합니다. 이 도구는 중복 키를 경고하고 마지막 값을 평가하므로 다른 파서에서 재사용하기 전에 키를 하나로 정리하세요.

예시

중첩된 이메일 하나 추출

입력
{
  "user": {
    "email": "dev@example.com"
  }
}
출력
$.user.email을 실행하면 $['user']['email'] 경로와 "dev@example.com" 값이 나옵니다.

배열을 필터링한 뒤 주문 ID 추출

입력
{
  "orders": [
    { "id": "ord_1001", "total": 49.99 },
    { "id": "ord_1002", "total": 9.5 }
  ]
}
출력
$.orders[?(@.total >= 20)].id를 실행하면 "ord_1001"만 나옵니다.

RFC 9535 평가 방식과 안전 제한

평가기에서는 RFC 9535의 루트·자식 구간, 재귀 탐색, 객체 속성, 배열 인덱스, 와일드카드, 슬라이스, 다중 선택자, 필터를 처리합니다. 음수 인덱스는 배열 끝에서부터 계산하며, 없는 속성은 오류 대신 일치 결과 0개로 처리합니다.

필터 표현식은 @로 현재 노드를 가리키고 문자열, 숫자, 불리언, null, 중첩 속성을 비교할 수 있습니다. 표현식은 JSONPath 문법으로 해석하며 임의 JavaScript나 스크립트 선택자를 실행하지 않습니다.

평가 전 입력을 엄격한 JSON으로 검증합니다. 파일 처리는 브라우저 안에서 끝나고 입력은 5MB, 결과는 5,000개로 제한합니다. 중복 키가 있으면 마지막 값을 사용하고 경고하므로 다른 파서와 결과가 달라질 가능성을 미리 확인할 수 있습니다.

자주 묻는 질문

입력한 JSON이 서버로 업로드되나요?

아니요. JSON 해석과 JSONPath 평가는 브라우저 안에서 실행됩니다. 붙여 넣은 payload, 선택한 JSON 파일, 표현식, 추출 결과를 변환 서버로 보내지 않습니다.

어떤 JSONPath 문법을 지원하나요?

RFC 9535를 기준으로 루트, 자식·하위 노드 탐색, 객체 속성, 배열 인덱스, 와일드카드, 음수 인덱스, 슬라이스, 다중 선택자, 필터 표현식을 지원합니다. 임의 JavaScript 선택자는 실행하지 않습니다.

JSONPath 필터와 슬라이스도 테스트할 수 있나요?

네. 예를 들어 $.orders[?(@.status == "paid")].id는 상태가 paid인 주문의 ID만 선택합니다. RFC 9535 문법으로 값 비교와 논리 조건을 조합할 수 있습니다.

JSON Formatter와 무엇이 다른가요?

JSON Formatter는 문서 전체를 읽기 좋게 정리하고 JSON 문법 오류를 찾습니다. JSONPath Tester는 유효한 문서에서 필요한 노드만 조회해 일치한 정확한 경로와 복사 가능한 값 모음을 보여줍니다.

이 도구를 검증한 방법

관리 및 검수 검토일

검증 방법: JSONPath 테스터 - JSON 값과 경로 추출 검토에서는 “API 응답에서 사용자 이메일과 주문 ID 추출”에 표시된 원본을 보존했습니다. “실제 JSON 응답 붙여 넣기”, “다음 작업으로 값 전달” 단계를 완료한 뒤 가능한 값은 그대로 대조했습니다. 연결된 실패 증거는 “JSON 문법 확인을 건너뜀”, “재귀 선택자를 너무 일찍 사용” 항목별로 확인했습니다.

기대 결과: 선택한 경로는 dev@example.com과 주문 ID 두 개를 반환했고, 정규화된 구체 경로는 관련 없는 total을 노출하지 않고 두 배열 원소를 가리켰습니다. wildcard 결과는 원본 배열 순서를 유지했고, 잘못된 JSON과 없는 필드는 정상적인 빈 문자열과 구분됐습니다.

검증한 작업 가이드 열기

관련 작업 가이드

도구를 열기 전에 자주 쓰는 작업 흐름과 예시를 확인하세요.

관련 도구

관리 중인 다른 작업 흐름을 이어서 사용해 보세요

모든 도구 둘러보기