쿼리 문자열 빌더

쿼리 문자열 빌더는 URL에서 물음표(?) 뒤에 오는 부분을 생성하고 검사할 수 있도록 도와줍니다. 이 도구는 검색 페이지, API 호출, 리다이렉트, 서명된 URL, UTM 캠페인 및 디버깅 티켓에 필요한 깔끔한 URL 매개변수를 생성해야 하는 개발자, 마케터, 분석가, QA 테스터 및 기술 지원 팀을 위해 제작되었습니다.

쿼리 문자열 빌더 사용 방법

1. 키-값 쌍이 있는 경우 빌드(Build) 모드를 사용하고, 이미 쿼리 문자열이나 URL이 있는 경우 디코딩(Decode) 모드를 사용합니다.
2. 빌드 모드에서는 한 줄에 하나의 키-값 쌍을 입력합니다. 디코딩 모드에서는 원시 쿼리 문자열 또는 전체 URL을 붙여넣습니다.
3. 공백을 더하기 기호(+)로 변경할지 퍼센트 인코딩된 공백(%20)으로 변경할지 선택하고, 반복되는 키를 표현하는 방식을 선택합니다.
4. 쿼리 문자열 빌드(Build Query String) 또는 쿼리 문자열 디코딩(Decode Query String)을 클릭하여 인코딩된 쿼리, 디코딩된 테이블, 경고 및 JSON 미리보기를 생성합니다.
5. 코드, 분석, API 또는 리다이렉트에서 사용할 수 있도록 쿼리 문자열, 물음표 버전, 전체 URL 또는 JSON 표현을 복사합니다.

인코딩 관련 참고 사항

쿼리 문자열은 조밀한 구조를 가지고 있으나, 미세한 인코딩 선택이 큰 차이를 만듭니다. 공백은 기존 폼 인코딩에서 +로 작성되거나 엄격한 퍼센트 인코딩에서 %20으로 작성될 수 있습니다. &, =, ?, #과 같은 예약어 및 ASCII가 아닌 문자(한글 등)가 URL 구조가 아닌 데이터 자체로 사용될 때는 퍼센트 인코딩되어야 합니다.

주요 용도

• 실수로 매개변수를 누락하는 일 없이 완벽한 UTM 캠페인 URL을 생성합니다.
• tag=python&tag=web과 같이 반복되는 필터를 사용하는 API 요청을 디버깅합니다.
• 리다이렉트 URL, OAuth 스코프, 검색 필터 및 분석 태그를 디코딩합니다.
• 코딩에 반영하기 전에 원시 쿼리 문자열과 정규화된 쿼리 문자열을 비교 확인합니다.

자주 묻는 질문 (FAQ)

URL 쿼리 문자열이란 무엇인가요?
URL 쿼리 문자열은 URL에서 물음표(?) 뒤에 오는 부분입니다. 브라우저, 서버, API 및 분석 도구가 작은 상태 정보를 전달할 수 있도록 q=url+tools&page=2와 같이 매개변수를 키-값 쌍으로 저장합니다.

공백은 +와 %20 중 어느 것으로 인코딩해야 하나요?
기존 HTML 양식 쿼리 문자열 및 많은 웹 애플리케이션 매개변수에는 더하기 기호(+)를 사용하십시오. 엄격한 퍼센트 인코딩, 서명된 URL, API 정규화 또는 RFC 3986에 더 가까운 스타일이 필요한 경우에는 %20을 사용하십시오.

반복되는 쿼리 키는 어떻게 처리되나요?
반복되는 키는 tag=one&tag=two로 유지하거나, tag[]=one&tag[]=two와 같은 대괄호 배열로 변환하거나, tag[0]=one&tag[1]=two와 같은 인덱스 배열로 변환할 수 있습니다. 백엔드 프레임워크마다 선호하는 규칙이 다릅니다.

디코더에 전체 URL을 붙여넣을 수 있나요?
네, 가능합니다. 디코더는 첫 번째 물음표 뒤의 부분을 추출하고, 디코딩 시 # 뒤의 프래그먼트는 무시하며, 정규화된 쿼리 문자열과 디코딩된 매개변수를 표시합니다.

이 도구는 제가 입력한 URL로 요청을 보내나요?
아닙니다. 이 도구는 텍스트를 빌드, 디코딩 및 표시하기만 합니다. 입력된 URL을 방문하거나 API 엔드포인트를 호출하지 않으며, 원격 서버가 매개변수를 수락하는지 여부를 검증하지 않습니다.

왜 중복되거나 비어 있는 쿼리 매개변수가 왜 중요한가요?
중복된 키와 빈 값은 서버가 요청을 해석하는 방식을 바꿀 수 있습니다. 일부 프레임워크는 중복을 배열로 변환하고, 일부는 첫 번째 또는 마지막 값만 유지하며, 일부는 빈 값을 누락된 매개변수와 다르게 취급합니다.