JSON 키·경로 추출기

JSON 키·경로 추출기 사용 가이드

처음 받는 API 응답이나 로그 JSON은 어떤 필드가 있는지부터 파악해야 합니다. 이 도구는 JSON 전체를 훑어 값이 있는 모든 자리의 경로를 'orders[].items[].sku' 같은 형태로 정리하고, 그 자리에 어떤 종류의 값이 들어 있었는지 함께 적어 줍니다.

배열 안의 항목은 번호마다 따로 적지 않고 '[]' 하나로 묶습니다. 주문 100건이 들어 있어도 orders[].id는 한 줄로 나오고, 옆에 '100곳'처럼 몇 번 나왔는지 표시되므로 응답의 구조를 한눈에 볼 수 있습니다.

같은 경로에서 값의 종류가 섞이면 'null | string'처럼 모두 적습니다. 어떤 주문에는 쿠폰이 있고 어떤 주문에는 null인 경우처럼, 코드에서 빈 값 처리가 필요한 필드를 찾는 데 쓸 수 있습니다.

사용 방법

1. 1'JSON' 칸에 구조를 확인할 JSON을 붙여 넣습니다.
2. 2'실행'을 누르면 경로마다 '(값 종류, 나온 횟수)'가 붙은 목록이 문서에 나온 순서대로 나옵니다.
3. 3필요한 경로를 복사해 JSONPath 식이나 매핑 설정에 활용합니다.

{"orders":[{"id":101,"coupon":null,"items":[{"sku":"A-1","qty":2}]},{"id":102,"coupon":"WELCOME","items":[]}]}

orders[].id (number, 2곳)
orders[].coupon (null | string, 2곳)
orders[].items[].sku (string)
orders[].items[].qty (number)
orders[].items (빈 배열)

이럴 때 쓰면 좋아요

• 외부 API 응답을 처음 받아 어떤 필드가 있는지 목록으로 정리할 때
• 값이 null로 오는 경우가 있는 필드를 찾아 예외 처리를 준비할 때
• 두 버전의 응답에서 경로 목록을 뽑아 비교 도구로 새 필드를 찾을 때
• 데이터 매핑 문서에 원본 필드 경로를 정확한 철자로 옮겨 적을 때

문제가 생겼을 때

활용 팁

• 나온 횟수가 배열 길이보다 적은 경로는 일부 항목에만 있는 선택 필드라는 뜻입니다.
• 타입 정의까지 필요하면 같은 샘플을 JSON → TypeScript 타입 도구에 넣어 선택 필드에 ?가 붙은 인터페이스를 받으세요.

자주 묻는 질문