개발 도구
URL 인코딩 변환기로 쿼리 파라미터 점검하는 체크리스트
공유 링크, API 예시, 한글 검색어가 깨지지 않도록 URL 인코딩과 디코딩을 실무에서 확인하는 방법입니다.
검색 의도: 링크에 한글, 공백, 특수문자를 넣었더니 깨질 때
관리자 화면에서 만든 필터 링크를 동료에게 보냈는데 상대 화면에서는 조건이 빠져 있거나, 캠페인 이름의 공백 뒤가 잘리거나, 값 안에 들어간 `&` 때문에 다른 파라미터로 해석되는 일이 있습니다. 만든 사람의 브라우저에서는 정상으로 보여도 복사와 공유를 거치면 링크의 의미가 달라질 수 있습니다.
URL 인코딩은 주소를 어렵게 보이게 만드는 절차가 아니라 사람이 입력한 검색어, 리다이렉트 주소, 파일명, 필터 값, 한글 문장을 URL 안에서 안전하게 전달하기 위한 확인 단계입니다. Sambro의 URL 인코딩 변환기는 https://tools.sambro.space/ko/tools/url-encoder 에서 바로 사용할 수 있습니다.
주소 전체가 아니라 값부터 나누기
가장 흔한 실수는 주소 전체를 통째로 인코딩하는 것입니다. 그러면 `https://`의 콜론과 슬래시, `?`, `=`, `&`처럼 주소 구조를 나누는 문자까지 바뀌어 일반적인 웹 링크가 깨질 수 있습니다. 실무에서는 기본 주소와 파라미터 값을 먼저 분리하는 편이 안전합니다.
예를 들어 `https://example.com/search?q=서울 사무실&sort=new`라면 위험한 부분은 보통 `q`의 값인 `서울 사무실`입니다. 한글과 공백은 인코딩되어야 서버가 하나의 검색어로 받습니다. 반대로 `?`, `=`, `&`는 구조 문자 역할을 계속 해야 합니다. 값 안에 또 다른 URL이나 특수문자가 들어갈 때만 그 값을 따로 인코딩합니다.
공유 전 5단계 점검
첫째, 기본 주소와 파라미터를 분리합니다. 둘째, 파라미터 이름과 값을 한 줄씩 적습니다. 셋째, 공백, 한글, 특수문자, 다른 URL이 들어간 값만 URL 인코딩합니다. 넷째, 다시 조립한 주소를 시크릿 창이나 깨끗한 브라우저 탭에서 열어 봅니다. 다섯째, 도착한 화면의 검색어, 필터, 정렬, 리다이렉트 목적지가 의도와 같은지 확인합니다.
이 과정은 캠페인 링크, 고객 지원 재현 경로, 관리자 필터, 웹훅 예시, API 문서 스니펫에서 특히 유용합니다. 링크 하나가 잘못되면 모두가 같은 주소를 열었다고 생각하지만 서버는 서로 다른 값을 받은 상태가 될 수 있습니다. 짧은 인코딩 점검이 그 시간을 줄여 줍니다.
디코딩은 읽기 위한 단계로 쓰기
URL 디코딩은 로그나 분석 도구에서 긴 주소를 받았을 때 도움이 됩니다. `%ED%95%9C%EA%B8%80%20%EA%B2%80%EC%83%89` 같은 값은 사람이 바로 읽기 어렵습니다. 한 번 디코딩하면 사용자가 어떤 한글 검색어를 넣었는지, 리다이렉트 값이 어디를 가리키는지, 추적 파라미터에 어떤 캠페인명이 들어갔는지 보입니다.
다만 디코딩한 문자열을 그대로 다른 곳에 붙여 넣으면 안 됩니다. 디코딩된 값에는 `&`, `=`, 따옴표, 줄바꿈처럼 다음 시스템에서 의미를 갖는 문자가 들어 있을 수 있습니다. 흐름은 디코딩해서 읽고, 의미를 판단하고, 다시 URL 안에 넣어야 한다면 필요한 값만 인코딩하는 식이 좋습니다.
Sambro 도구와 함께 쓰는 위치
한글 검색어, 리다이렉트 주소, API 요청 예시, 공유 링크가 조금이라도 불안하면 https://tools.sambro.space/ko/tools/url-encoder 의 URL 인코딩 변환기로 값을 확인할 수 있습니다. 같은 디버깅 흐름에서 JSON 로그나 웹훅 본문을 같이 봐야 한다면 https://tools.sambro.space/ko/tools/json-formatter 의 JSON 포맷터로 구조를 먼저 읽는 편이 좋습니다.
다른 브라우저 유틸리티는 https://tools.sambro.space/ko/tools 에서 함께 확인할 수 있습니다. 회사 소개나 서비스 문의 맥락은 https://sambro.space/ 를 기준으로 확인하면 됩니다.