쿼리 스트링 파서

URL 쿼리 스트링과 form-urlencoded 페이로드를 브라우저에서 로컬로 파싱하여 편집 가능한 키-값 테이블 및 JSON으로 변환하세요.

업로드 없음회원가입 없음즉각적인 결과
대화형 키-값 토글 편집기배열 및 중첩 대괄호 → JSONx-www-form-urlencoded (+) vs 엄격한 %20
쿼리 스트링 분석
오프라인 엔진 준비 완료브라우저 내 100% 개인정보 보호 • 클라우드 업로드 없음
100% 비공개 • 서버 파일 업로드 제로

Utiliome의 무료 쿼리 스트링 파서를 사용하는 이유

철저한 개인정보 보호, 즉각적인 실행, 번거로움 없는 사용을 위해 처음부터 설계되었습니다. 구독, 결제, 회원가입이 필요 없습니다.

양방향 쿼리 스트링 및 JSON 변환기

?key=value 문자열이나 application/x-www-form-urlencoded 본문을 깔끔한 JSON 객체로 파싱하고, 편집된 JSON을 다시 정규화된 쿼리 파라미터로 즉시 직렬화합니다.

중복 배열 키 및 중첩 대괄호 구문 처리

중복 키(?tag=go&tag=rust), 명시적 배열 대괄호(ids[]=1&ids[]=2), 중첩된 객체 계층 구조(filter[status]=open&page[limit]=50)를 정확하게 해석합니다.

+ 및 %20 공백 직렬화 방식 선택 가능

입력 시 URLSearchParams 규칙에 따라 +와 %20 공백을 모두 디코딩하며, 재구성 시에는 엄격한 RFC 3986(%20) 또는 HTML 폼(+) 공백 인코딩 방식을 선택하여 내보낼 수 있습니다.

서버 전송 없는 대화형 파라미터 테이블

API 키, OAuth 상태 토큰, 웹훅 페이로드를 외부 서버에 노출하지 않고 브라우저 메모리 내에서 로컬로 파라미터를 추가, 토글, 편집 또는 삭제할 수 있습니다.

Utiliome vs 기존 클라우드 대안

로컬 우선 WebAssembly 엔진과 기존 클라우드 도구를 비교해 보세요.

기능 Utiliome (로컬 브라우저) 기존 클라우드 변환기
양방향 쿼리 스트링 및 JSON 변환기 ?key=value 문자열이나 application/x-www-form-urlencoded 본문을 깔끔한 JSON 객체로 파싱하고, 편집된 JSON을 다시 정규화된 쿼리 파라미터로 즉시 직렬화합니다. 고급 설정이 없는 제한적인 기본 옵션
중복 배열 키 및 중첩 대괄호 구문 처리 중복 키(?tag=go&tag=rust), 명시적 배열 대괄호(ids[]=1&ids[]=2), 중첩된 객체 계층 구조(filter[status]=open&page[limit]=50)를 정확하게 해석합니다. 별도 프로그램 설치나 수동 작업이 필요함
데이터 개인정보 보호 및 처리 100% 브라우저 로컬 처리 (서버 업로드 제로) 데이터를 외부 클라우드 서버로 전송 및 저장
이용 요금 및 회원가입 평생 100% 무료 · 회원가입 및 로그인 불필요 회원가입 강제 또는 유료 구독 결제 필요
작동 방식

간단한 3단계 쿼리 스트링 파서 사용법

소프트웨어 설치가 필요 없습니다. 웹 브라우저 내에서 모든 작업이 직접 실행됩니다.

1

쿼리 스트링, 전체 URL 또는 JSON 붙여넣기

원시 ?a=1&b=2 쿼리 스트링, 전체 URL(파서가 자동으로 검색 컴포넌트만 분리함), application/x-www-form-urlencoded 본문 또는 유효한 JSON을 입력합니다.

2

키, 배열 및 인코딩 옵션 편집

대화형 키-값 테이블이나 JSON 편집기에서 디코딩된 이름과 값을 수정하고, 개별 행을 켜거나 끄며, 배열 및 공백 인코딩 모드를 선택합니다.

3

재구성된 쿼리 스트링 또는 JSON 복사

cURL 명령어 및 API 클라이언트용으로 깔끔하게 이스케이프된 쿼리 스트링을 복사하거나, 구조화된 JSON 문서를 테스트 스위트 및 요청 픽스처로 직접 내보냅니다.

복잡한 쿼리 스트링 및 폼 페이로드를 JSON으로 변환하기

빠른 답변: 쿼리 스트링 파서는 디코딩 전에 먼저 입력 바이트를 & 구분자로 분할하고, 각 토큰을 첫 번째 =에서 분리한 뒤, + 및 %XX UTF-8 시퀀스를 디코딩하여 중복 키나 대괄호 키(tag=a&tag=b, filter[status]=open)를 JSON 배열 및 중첩 객체로 집계합니다.

최신 REST, GET 기반 GraphQL 및 웹훅 엔드포인트는 다중 값 배열, 중첩 필터 객체, Base64 커서, URL 인코딩된 검색 구문을 단일 쿼리 스트링이나 application/x-www-form-urlencoded 요청 본문에 담아 전송하는 경우가 많습니다. 이러한 페이로드를 평면적인 원시 문자열 상태로 검사하거나 편집하면 %26 이스케이프가 깨지거나 대괄호 짝이 맞지 않는 오류가 발생하기 쉽습니다.

예를 들어 +로 인코딩된 공백, 중복 키, 중첩 대괄호 필터, 퍼센트 인코딩된 = 패딩이 포함된 Base64 페이지네이션 커서, 그리고 값 없는 플래그 파라미터가 결합된 API 검색 쿼리를 살펴보겠습니다.

?q=distributed+tracing&tag=otel&tag=grpc&filter[status]=open&filter[priority]=high&cursor=eyJpZCI6NDIwfQ%3D%3D&dry_run

이 문자열을 파싱하면 가독성이 뛰어나고 명확하게 구조화된 JSON 표현이 즉시 생성됩니다.

{
  "q": "distributed tracing",
  "tag": [
    "otel",
    "grpc"
  ],
  "filter": {
    "status": "open",
    "priority": "high"
  },
  "cursor": "eyJpZCI6NDIwfQ==",
  "dry_run": ""
}

구분자 분할이 퍼센트 디코딩보다 먼저 이루어져야 하는 이유

cursor=eyJpZCI6NDIwfQ%3D%3D가 "eyJpZCI6NDIwfQ=="로 깔끔하게 디코딩된 점에 주목하세요. 파서는 원시 문자열을 먼저 &로 분할하고, 각 쌍을 첫 번째 리터럴 =로 분할한 다음에야 비로소 +와 %XX 시퀀스를 디코딩합니다. 만약 단순한 스크립트가 &와 =로 분할하기 전에 전체 쿼리 스트링에 대해 decodeURIComponent()를 실행한다면, 이스케이프된 앰퍼샌드를 포함한 파라미터 값(R%26D -> R&D)이 두 개의 잘못된 파라미터로 쪼개지게 됩니다.

JSON 뷰와 키-값 테이블은 양방향으로 동기화되므로, 애플리케이션 코드에서 JSON 필터 객체를 붙여넣어 HTTP 요청에 바로 사용할 수 있는 올바르게 이스케이프된 쿼리 스트링을 즉시 직렬화할 수도 있습니다.

WHATWG URLSearchParams와 RFC 3986 비교 및 백엔드 배열 규칙

빠른 답변: RFC 3986은 쿼리 컴포넌트를 공백이 %20으로 인코딩되고 +가 리터럴로 유지되는 비구조화 문자열로 취급하는 반면, WHATWG application/x-www-form-urlencoded 표준(URLSearchParams)은 공백을 +로 인코딩하며 배열 및 중첩 객체 구문은 프레임워크 규칙에 맡깁니다.

웹의 쿼리 스트링에는 두 가지 서로 다른 명세가 적용되며, 이 둘 사이의 불일치는 HTTP 통합 과정에서 발생하는 서명 검증 실패와 파라미터 버그의 가장 흔한 원인 중 하나입니다.

`application/x-www-form-urlencoded` 알고리즘과 RFC 3986 비교

HTML 폼과 JavaScript URLSearchParams API는 WHATWG application/x-www-form-urlencoded 파서를 구현합니다.

  1. location.search에서 추출하는 경우 맨 앞의 ?를 제거합니다.
  2. 입력을 바이트 0x26(&) 기준으로 분할하며, &&나 맨 앞의 &로 인해 생기는 빈 바이트 시퀀스는 무시합니다.
  3. 각 청크를 첫 번째 0x3D(=)에서 분할합니다. =가 없으면 청크 전체가 이름이 되고 값은 기본값인 ""가 됩니다.
  4. 이름과 값 양쪽에서 모든 0x2B(+) 바이트를 0x20(ASCII 공백)으로 바꿉니다.
  5. %XX 16진수 바이트 시퀀스를 UTF-8로 퍼센트 디코딩하며, 잘못된 형식의 바이트 시퀀스는 U+FFFD로 대체합니다.

반면, RFC 3986 Section 3.4 는 +를 공백으로 특별 취급하지 않고 URI 쿼리 컴포넌트를 정의합니다. 엄격한 암호화 서명 프로토콜(특히 AWS Signature Version 4 및 OAuth 2.0 / RFC 5849 정규 요청)에서는 공백을 %20으로 인코딩하고 +를 %2B로 인코딩해야 합니다. 서명된 API를 대상으로 할 때는 + 대신 %20 공백 직렬화를 사용하여 쿼리 스트링을 재구성하세요.

프레임워크별 배열 및 객체 직렬화 방식

RFC 3986과 URLSearchParams 모두 중첩 배열이나 객체를 표준화하지 않습니다. 백엔드 생태계에서는 주로 다음 네 가지 규칙이 발전해 왔습니다.

# 1. 중복 키 (WHATWG URLSearchParams.getAll, Go net/url, Python parse_qs, Java Servlet)
?tag=otel&tag=grpc

# 2. 인덱스 없는 대괄호 (PHP $_GET, Ruby on Rails / Rack, Express qs)
?tag[]=otel&tag[]=grpc

# 3. 인덱스 있는 대괄호 (Node.js qs 정렬 배열)
?tag[0]=otel&tag[1]=grpc

# 4. 중첩 객체 키 (Node.js qs, Rails, PHP, Stripe REST API)
?filter[status]=open&filter[created][gte]=1730000000

직렬화하기 전에 대상 서버가 어떤 형식을 기대하는지 확인해야 합니다. 표준 PHP $_GET['tag']에 tag=otel&tag=grpc를 전송하면 tag[] 대괄호를 사용하지 않는 한 첫 번째 값이 덮어쓰여져 스칼라 값 "grpc"만 반환되는 반면, Go의 r.URL.Query()["tag"]는 대괄호가 없는 tag 키를 기대합니다.

보안 특성: HTTP 파라미터 오염 및 프로토타입 오염

  • HTTP 파라미터 오염(HPP: HTTP Parameter Pollution): 중복된 스칼라 키(?account=user_1&account=user_2)가 전달될 때 서버 런타임마다 충돌을 해결하는 방식이 다릅니다. Python urllib.parse.parse_qs와 Go Values.Get()은 첫 번째 값을 읽고, PHP와 Ruby Rack은 마지막 값을 읽으며, Node/Express는 배열 (["user_1", "user_2"])을 생성합니다. 만약 API 게이트웨이는 첫 번째 값으로 권한을 검사하고 업스트림 마이크로서비스는 마지막 값을 처리한다면 인가 검사가 우회될 수 있습니다.
  • 대괄호 파서의 프로토타입 오염(Prototype Pollution): Object.prototype에 직접 obj[key1][key2] = val을 할당하는 단순한 JavaScript 대괄호 파서는 ?__proto__[isAdmin]=true 또는 ?constructor[prototype][isAdmin]=true와 같은 페이로드에 취약합니다. 안전한 파서는 Object.create(null) 딕셔너리를 인스턴스화하고, 예약된 프로토타입 키를 차단하며, 중첩 깊이 제한을 적용합니다.

쿼리 스트링 파서 vs URL 구성 요소 파서 vs URL 인코더: 어떤 도구가 필요한가요?

빠른 답변: 대화형 파라미터 편집, 배열/대괄호 파싱 및 양방향 JSON 변환에는 '쿼리 스트링 파서'를 사용하세요. 스킴, 호스트, 포트, 경로 세그먼트 및 해시를 분할하거나 편집해야 할 때는 'URL 구성 요소 파서'를, 개별 원시 문자열을 이스케이프할 때는 'URL 인코더 및 디코더'를 사용합니다.

Utiliome의 URL 도구 모음에 속한 각 도구는 고유한 작업 범위를 전담하므로 불필요한 복잡함 없이 목적에 맞는 전용 기능을 제공합니다.

기능 쿼리 스트링 파서 (현재 도구) URL 구성 요소 파서 URL 인코더 및 디코더 퍼센트 인코더
주요 초점 쿼리 파라미터, 폼 본문 및 JSON 동기화 전체 URI 구조 분석 (RFC 3986 / WHATWG) 원시 문자열 이스케이프 및 언이스케이프 엄격한 RFC 3986 %XX 바이트 인코딩
양방향 JSON 변환 완벽 지원 (중첩 객체 및 배열) URI 필드의 읽기 전용 JSON 내보내기 해당 없음 해당 없음
배열 및 대괄호 구문 (a[]=1, f[k]=v) 네이티브 파싱 및 재구성 형식 설정 가능 평면적인 쿼리 쌍 표시 해당 없음 해당 없음
+ vs %20 공백 직렬화 전환 출력 시 설정 가능 표준 URI 컴포넌트 정규화 컴포넌트(%20) 및 폼(+) 모드 엄격한 %20 전용
스킴, 호스트, 포트, TLD 및 경로 편집 쿼리 외 URL 구성 요소 자동 제거 전체 구성 요소 편집 및 재구성 구조적 파싱 없음 구조적 파싱 없음

올바른 워크플로 선택하기

  • 스킴, 서브도메인, TLD, 포트, 경로 세그먼트 또는 프래그먼트 검사 및 수정: URL 구성 요소 파서로 전환하여 모든 RFC 3986 경계에 걸쳐 전체 URL을 확인하고 재구성하세요.
  • 예약 문자(&, =, +, /)가 포함된 단일 원시 값 이스케이프: URL 인코더 및 디코더를 사용하여 개별 문자열을 깔끔하게 인코딩하거나 디코딩하세요.
  • 엄격한 RFC 3986 정규 이스케이프(!, ', (, ), * -> %XX) 생성: OAuth 1.0a 또는 AWS SigV4 정규 쿼리 값을 구성할 때는 퍼센트 인코더를 사용하세요.
FAQ

쿼리 스트링 파서 자주 묻는 질문 및 기술 가이드

Utiliome의 무료 온라인 쿼리 스트링 파서 사용에 관한 모든 정보.

URL 파라미터에 있는 리터럴 플러스 기호(+)가 왜 공백으로 디코딩되나요?

application/x-www-form-urlencoded 표준 및 브라우저 URLSearchParams에서 0x2B(+)는 인코딩된 공백(0x20)을 나타내기 때문입니다. 파라미터 값에 ISO 8601 타임스탬프 오프셋(2026-11-01T09:30:00+01:00), Base64 토큰 또는 E.164 전화번호(+14155550100)와 같은 리터럴 플러스 기호가 포함되어 있다면 반드시 %2B로 전송해야 합니다. URL 인코더 및 디코더에서 개별 원시 문자열을 미리 이스케이프할 수 있습니다.

?tag=api&tag=cli 같은 중복 키는 JSON으로 변환될 때 어떻게 표현되나요?

RFC 8259 JSON 객체는 각 수준에서 고유한 키를 요구하므로, 중복된 파라미터 이름은 등장 순서대로 그룹화되어 { "tag": ["api", "cli"] } 형태의 JSON 배열로 변환됩니다. 해당 JSON 배열을 다시 쿼리 스트링으로 변환할 때는 중복 키(tag=api&tag=cli), 빈 대괄호(tag[]=api&tag[]=cli), 또는 인덱스가 있는 대괄호(tag[0]=api&tag[1]=cli) 중 원하는 방식으로 직렬화할 수 있습니다.

전체 URL이나 application/x-www-form-urlencoded POST 본문을 직접 붙여넣을 수 있나요?

네, 가능합니다. https://api.example.com/v2/events?limit=25&cursor=abc#section과 같은 전체 URL을 붙여넣으면 파서가 ?와 # 사이의 쿼리 부분 문자열(limit=25&cursor=abc)만 자동으로 분리합니다. 앞에 ?가 없는 원시 application/x-www-form-urlencoded 요청 본문도 동일하게 파싱됩니다. 호스트 이름, 포트, 경로 세그먼트 또는 해시까지 함께 편집해야 한다면 URL 구성 요소 파서에서 주소를 여세요.

?debug나 ?dry_run처럼 등호(=)가 없는 플래그 파라미터는 어떻게 처리되나요?

WHATWG URLSearchParams 파싱 알고리즘에 따라 =가 없는 파라미터 청크는 디코딩된 파라미터 키가 청크 이름("dry_run")으로 설정되고 값은 빈 문자열("")이 됩니다. 대화형 테이블에서 true와 같은 명시적인 값을 할당하거나, 파라미터를 삭제하거나, 빈 문자열 상태로 유지할 수 있습니다.

API 키, OAuth 토큰 또는 웹훅 파라미터가 백엔드 서버로 전송되나요?

아니요. 파싱, 테이블 편집 및 JSON 직렬화는 클라이언트 사이드 JavaScript를 통해 사용자의 브라우저 내에서 100% 로컬로 실행됩니다. 민감한 쿼리 자격 증명, access_token 값 및 내부 분석 페이로드는 절대 외부로 전송되지 않습니다.