JSON Path Tester 사용법: JSON 경로로 값 추출하기

JSON 경로 조회의 목적과 준비

JSON Path Tester는 JSON 형식의 텍스트 안에서 필요한 값을 경로 표현식으로 찾아보는 도구입니다. 중첩된 객체를 따라가거나 리스트의 여러 항목을 살펴봐야 할 때 입력 데이터와 조회 경로의 조합을 빠르게 점검할 수 있습니다. 결과를 통해 경로가 JSON 구조와 맞는지, 해당 위치에서 몇 개의 값이 발견되는지 확인할 수 있습니다.

이 도구는 점으로 이어진 객체 속성 경로, 와일드카드, 리스트 인덱스와 인덱스 범위를 지원하는 동작을 제공합니다. 예를 들어 객체 안의 특정 속성을 단계별로 지정하거나, 리스트 항목을 순서로 가리키거나, 여러 항목을 한 경로에서 탐색할 수 있습니다. 다만 지원이 확인된 경로 형태 안에서 표현식을 작성해야 하므로, 다른 JSONPath 도구에서 사용한 문법이 그대로 처리된다고 단정하기는 어렵습니다.

JSON 입력과 경로는 텍스트로 전달되며 둘 다 선택 사항입니다. 아직 조회할 데이터를 준비하지 않았거나 경로를 입력하지 않은 상태에서 실행하면 어떤 값이 발견되었는지 확인하는 용도가 아니라 빈 입력의 처리 결과를 점검하는 상황이 됩니다.

JSON 입력과 경로를 확인하는 순서

조회할 JSON 텍스트를 준비합니다. 객체와 리스트가 함께 들어 있는 경우에도 JSON 문법에 맞는 텍스트를 입력해야 하며, 속성 이름과 배열 구조를 먼저 살펴보면 경로를 정하기 쉽습니다.
JSON을 입력 영역에 붙여 넣습니다. 입력은 선택 사항이지만, 실제 값을 찾아보려면 공백만 있는 내용이 아닌 JSON 텍스트가 필요합니다. 데이터의 시작과 끝에 불필요한 문자가 섞이지 않았는지도 확인합니다.
조회할 위치를 경로 표현식으로 적습니다. 객체 속성은 점으로 구분해 이어 쓰고, 리스트 항목을 따라갈 때는 지원되는 대괄호 인덱스 또는 인덱스 범위를 사용합니다. 여러 객체의 값이나 리스트의 항목을 순회하려면 와일드카드를 경로의 해당 위치에 배치할 수 있습니다.
입력한 JSON과 경로를 한 번 더 대조합니다. 속성 이름의 철자, 점의 위치, 대괄호의 짝, 인덱스 숫자와 범위 표기를 차례로 살펴보면 경로 자체의 실수를 줄일 수 있습니다. 경로를 입력하지 않았거나 공백뿐인 경우에는 조회 단계보다 먼저 빈 입력 처리가 적용됩니다.
실행 컨트롤을 선택해 경로 조회를 시작합니다. 입력 JSON과 경로에 공백이 아닌 내용이 모두 있고 JSON 문법이 올바르면, 경로가 값을 찾지 못하는 경우에도 성공 결과가 반환될 수 있습니다.
성공 결과의 값을 확인합니다. 결과에는 찾아낸 값, 발견된 값의 개수, 제출한 경로가 포함되므로 세 항목을 함께 읽어야 조회 결과와 사용한 표현식을 연결해서 이해할 수 있습니다.
실패 결과가 나타나면 먼저 JSON 문법을 점검합니다. JSON과 경로에 내용이 있는 상태에서 JSON이 유효하지 않으면 정상적인 추출 성공으로 처리되지 않습니다. JSON을 고친 뒤 속성 경로와 리스트 표기를 다시 확인하고 재시도합니다.

성공, 빈 결과, 실패를 구분하는 법

성공 결과에 값이 표시되면 해당 경로를 따라 JSON 안에서 찾은 항목이 있다는 뜻입니다. 값의 개수는 발견된 항목 수를 보여 주며, 같은 경로로 여러 리스트 요소를 조회했을 때 결과 규모를 가늠하는 데 사용할 수 있습니다. 함께 표시되는 경로는 제출한 표현식을 다시 확인하는 기준이 됩니다.

값 목록이 비어 있어도 유효한 JSON과 정상적으로 완료된 경로 조회에서는 성공 결과가 나올 수 있습니다. 따라서 빈 일치 목록만으로 입력 JSON의 오류를 판단하지 말고, 속성 이름과 객체의 중첩 순서가 실제 구조와 맞는지 먼저 비교해야 합니다. 빈 입력이나 공백 입력도 일치 항목 없이 성공 처리되므로, 이 경우에는 조회할 데이터가 전달되었는지부터 살펴보는 편이 좋습니다.

JSON과 경로가 모두 비어 있지 않은데 JSON 문법이 올바르지 않다면 실패 결과가 나타날 수 있습니다. 이 상황은 경로가 값을 찾지 못한 경우와 구별해야 합니다. JSON을 수정했는데도 정상적인 결과 형태가 보이지 않는다면 대괄호 안의 인덱스와 범위, 괄호의 짝, 경로에 사용한 기호를 점검하세요.

잘못된 경로 표현식은 유형에 따라 일반적인 실패 결과 형태로 정리되지 않고 추출이 중단될 수도 있습니다. 특히 대괄호 인덱스나 범위를 지원되는 형식과 다르게 작성한 경우에는 결과 항목을 기다리기보다 표현식을 단순한 객체 속성 경로 또는 확인된 리스트 표기로 바꾸어 보는 것이 안전합니다. 이 도구의 동작이 확인된 범위는 일부 경로 형태이므로 완전한 JSONPath 표준 문법 전체를 지원한다고 해석해서는 안 됩니다.

사용 예시

사용자는 사용자 목록에서 각 객체의 name 속성을 한 번에 확인하려고 합니다.

JSON 텍스트에 {"users":[{"name":"민서"},{"name":"준호"}]}를 입력하고 users[*].name 경로를 제출합니다.

처리가 성공하면 찾은 값, 찾은 값의 개수, 입력한 경로가 포함된 결과 형태를 확인할 수 있습니다.

제한 사항

확인된 지원 범위는 객체 속성, 와일드카드, 리스트 인덱스와 인덱스 범위입니다. 잘못된 경로 표현식은 일반적인 실패 결과 대신 추출을 중단시킬 수 있습니다.

자주 발생하는 오류

대괄호의 인덱스나 범위를 익숙한 다른 표기법으로 입력하면 정상적인 결과 형태가 나오지 않고 추출이 중단될 수 있습니다. 해당 부분을 지원되는 리스트 인덱스 또는 인덱스 범위로 고쳐 쓰고, 객체 속성은 점으로 연결해 다시 조회하세요.

자주 묻는 질문

JSON 입력을 비워 두면 어떻게 되나요?

JSON 입력 또는 경로가 비어 있거나 공백뿐인 조건에서는 일치 항목 없이 성공 처리됩니다. 실제 값을 조회하려면 JSON 텍스트와 경로에 각각 조회에 필요한 내용을 입력해야 합니다.

값을 찾지 못하면 JSON이 잘못된 것인가요?

유효한 JSON에서 경로가 구조와 맞지 않는 조건이면 성공 결과 안에 일치 항목이 없을 수 있습니다. 반면 JSON과 경로에 내용이 있고 JSON 문법이 잘못된 경우에는 성공적인 추출이 아닌 실패 결과가 나옵니다.

어떤 경로 표현식을 사용할 수 있나요?

점으로 구분한 객체 속성 경로와 와일드카드, 대괄호를 이용한 리스트 인덱스 및 인덱스 범위가 지원되는 형태입니다. 그 범위를 벗어난 표현식이나 잘못된 대괄호 문법은 일반 결과 구조 없이 추출을 중단시킬 수 있습니다.