Query String ↔ JSON 변환기

언제 사용하나요?

URL 뒤에 붙은 쿼리스트링을 JSON 객체로 펼쳐 파라미터를 확인하거나, JSON 객체를 URLSearchParams 형식으로 변환해 API 요청 URL을 만들어야 할 때 사용합니다.

사용 방법

• 변환 방향(Query String → JSON 또는 JSON → Query String)을 선택합니다.
• 데이터를 입력합니다.
• 변환 결과를 복사합니다.

입력값 안내

URL 뒤에 붙는 쿼리스트링(예: ?id=1&name=abc) 또는 파라미터로 만들 JSON 객체를 입력합니다.

계산·변환 기준

URLSearchParams API를 활용하여 `key=value&` 패턴의 문자열을 객체 형태로 디코딩/인코딩하며, decodeURIComponent 및 encodeURIComponent를 함께 적용해 특수문자와 한글을 안전하게 변환합니다.

사용 예시

• API 요청 파라미터 확인 - URL 뒤의 쿼리스트링을 JSON 객체로 펼쳐 확인합니다.
• 테스트 URL 생성 - JSON 객체를 URLSearchParams 형식의 쿼리스트링으로 변환합니다.
• 파라미터 디버깅 - 복잡한 쿼리스트링을 JSON으로 펼쳐 어떤 값이 들어 있는지 확인합니다.

예시

• "name=홍길동&age=30" → {"name":"홍길동","age":"30"}
• {"name":"홍길동","age":30} → "name=%ED%99%8D%EA%B8%B8%EB%8F%99&age=30"
• "page=1&limit=20&sort=desc&filter=active" → 4개 키-값 JSON 객체로 파싱
• {"search":"hello world","page":2} → "search=hello+world&page=2" 인코딩 변환
• GET 요청 URL 뒤 긴 쿼리스트링 → JSON으로 펼쳐 각 파라미터 의미 빠르게 파악
• 복잡한 필터 파라미터 JSON → URL 인코딩된 쿼리스트링으로 변환해 API 테스트

주의사항

• 모든 값은 문자열로 파싱됩니다. 숫자처럼 보이는 값도 JSON에서는 문자열이 될 수 있으니 타입을 확인하세요.
• 중첩 객체나 배열은 쿼리스트링으로 완전히 표현되지 않을 수 있습니다. 복잡한 구조는 JSON 직렬화를 검토하세요.

계산·사용 가이드

Query String 구조

Query String은 URL 뒤의 ? 다음에 key=value 쌍을 &로 이어 붙인 형식입니다. 같은 key가 여러 번 나오면 배열처럼 다룰 수 있습니다.

URL 인코딩 확인

한글, 공백, 특수문자는 URL 인코딩이 필요합니다. 깨져 보이는 값은 URL 인코딩/디코딩 도구와 함께 확인하세요.

자주 묻는 질문

반복되는 키는 어떻게 처리되나요?

같은 키가 여러 번 나오면 JSON 배열로 보존합니다.

한글은 인코딩되나요?

JSON → Query String 변환 시 URLSearchParams 기준으로 자동 인코딩됩니다.

?로 시작하는 전체 URL을 넣어도 되나요?

URL에서 ? 뒤의 쿼리스트링 부분을 인식해 변환합니다.

값이 없는 키도 처리되나요?

네. 값이 빈 키는 빈 문자열로 변환됩니다.

관련 도구

• JSON 포매터 - JSON 문자열을 보기 좋게 들여쓰기하거나 최소화합니다. 유효성 오류도 함께 표시합니다.
• YAML ↔ JSON 변환기 - YAML과 JSON 데이터를 브라우저에서 양방향으로 변환합니다.
• 파일 크기 변환기 - Byte, KB, MB, GB, TB 파일 크기 단위를 1000 또는 1024 기준으로 변환합니다.
• Markdown → HTML 변환기 - Markdown 문서를 HTML로 변환하고 렌더링 미리보기를 제공합니다.
• CSV ↔ JSON 변환기 - CSV와 JSON 배열 데이터를 양방향으로 변환합니다.
• px ↔ rem 변환기 - 기준 폰트 크기를 바탕으로 px와 rem 값을 양방향 변환합니다.