URL 인코딩과 쿼리 분석 사용 안내
검색어를 API에 전달할 때 &나 +가 다른 의미로 해석되면 요청값이 바뀔 수 있습니다. 이 도구는 쿼리에 넣을 값 한 개를 인코딩하거나, 받은 문자열을 디코딩하고, 전체 주소의 구성과 반복되는 쿼리 값을 확인하는 용도로 제공합니다. 입력한 주소를 방문하거나 서버에 요청하지 않습니다.
어떤 버튼을 사용하면 되나요?
- URL 인코딩: 검색어처럼 URL 안에 들어갈 값만 입력합니다. 예를 들어
가 & 나는%EA%B0%80%20%26%20%EB%82%98가 됩니다. 입력 앞뒤의 공백도 데이터로 보존합니다. - URL 디코딩: 인코딩된 값을 한 번만 풉니다.
%EA%B0%80는가가 됩니다.%252F는 한 번 풀면%2F이며, 자동으로 여러 번 풀지 않습니다. - URL 파싱:
https://example.com/search?tag=web&tag=api&q=A%2BB#result를 입력하면 경로/search, 두 개의tag값,q = A+B와 프래그먼트를 나누어 보여줍니다. '쿼리 예제 넣기'로 직접 확인할 수 있습니다.
encodeURIComponent를 사용하므로 https://의 구분 기호도 바뀝니다. 전체 주소를 살펴볼 때는 파싱 버튼을 사용하고, 링크를 조립할 때는 URL 전체가 아닌 각 값에 적용하세요.플러스(+), 공백, %2B의 차이
일반 디코딩은 A+B를 그대로 보존합니다. 폼 데이터 옵션을 켜면 A+B가 A B로 바뀝니다. A%2BB는 두 모드 모두 A+B입니다. 파서의 쿼리 분석은 URLSearchParams 규칙을 따르므로 쿼리의 +를 공백으로 해석합니다. 실제 플러스를 전달하려면 %2B를 사용하세요.
URL을 직접 이어 붙이지 않고 조립하기
기본 주소에 https://example.com/search를 넣고, 이름 q·값 A+B & 한글을 추가하면 플러스는 %2B, 앰퍼샌드는 %26, 공백은 +로 변환됩니다. 값에 이미 인코딩된 %2F를 넣으면 퍼센트 자체가 다시 인코딩됩니다. 편집기에는 원래 값을 입력하세요.
같은 키를 여러 행에 적으면 tag=web&tag=api처럼 반복 키를 보존합니다. 값이 비어 있으면 empty=가 되고, 이름이 빈 행은 허용하지 않습니다. 잘못 추가한 행은 ‘삭제’로 제거하세요. 프래그먼트 #result는 주소 마지막에 유지됩니다.
‘위 입력 URL 불러오기’는 구조를 분석해 편집기에 채웁니다. 인증 사용자명·비밀번호가 들어 있는 주소는 불러오지 않습니다. 다시 조립하면 URLSearchParams 규칙으로 공백·특수문자 표기가 정규화되므로 서명된 URL, 결제 링크, 다운로드 토큰 주소에는 사용하지 마세요. 원본 쿼리의 바이트 표현을 보존하는 편집기는 아닙니다.
결과가 예상과 다를 때
- 잘못된 % 문자열:
%ZZ, 끝에 남은%, 잘린 UTF-8 값은 디코딩할 수 없습니다. 요청 로그의 원본이 잘렸는지 확인하세요. - 깨진 한글: 이 도구는 JavaScript의 UTF-8 기반 변환을 사용합니다. EUC-KR 등 다른 문자 인코딩의 퍼센트 문자열은 올바르게 복원되지 않을 수 있습니다.
- 반복되는 키:
tag=web&tag=api를 하나의 값으로 합치지 않습니다. 중복 키를 서버가 어떻게 처리하는지는 서버 구현에 따라 다릅니다. - 주소 형식: 파서는
http://또는https://가 있는 전체 주소만 받습니다. 상대 경로와javascript:같은 다른 스킴은 지원하지 않습니다. 파싱 성공은 주소가 실제 존재하거나 안전하다는 뜻이 아닙니다. - 브라우저 정규화: 호스트 이름의 대소문자, 기본 포트, 일부 경로 표기는 URL 파서가 정규화할 수 있습니다. 서명 검증용 원본 요청을 보관하는 용도로는 사용하지 마세요.
참고 자료
MDN: encodeURIComponent · MDN: URLSearchParams. 위 예제는 이 페이지의 변환 방식으로 확인할 수 있습니다.
개인정보와 외부 서비스
변환 코드는 입력과 결과를 이 페이지의 메모리에서 처리하며 별도 저장소에 기록하거나 변환 서버로 전송하지 않습니다. 복사를 선택하면 결과가 기기의 클립보드에 들어갑니다. 입력을 비우려면 초기화를 누르세요. 로그인 토큰이나 비밀번호가 포함된 실제 URL 대신 민감한 값을 지운 예제를 사용하세요.
페이지 제공에는 Cloudflare, 광고에는 Google AdSense를 사용합니다. 페이지를 방문하면 이 서비스에 IP 주소와 브라우저·접속 정보가 전달될 수 있고, 광고 제공에 쿠키 등이 사용될 수 있습니다. 입력을 로컬에서 처리한다는 설명은 외부 서비스로의 모든 통신이 없다는 뜻은 아닙니다. Google 광고 안내 · Cloudflare 개인정보처리방침.
운영 정보와 오류 제보
DevTool Hub에서 제공하는 무료 URL 변환 도구입니다. 구현과 변경 사항은 소스 저장소에서 확인할 수 있습니다. 오류·개인정보·광고 문의에는 브라우저와 실행 버튼, 개인정보를 제거한 입력 예제, 기대한 결과를 적어 주세요. 다른 도구는 DevTool Hub에서 찾을 수 있습니다.