Tools mentioned in this article
Open the browser-based tool while you read and try the workflow immediately.
URL에 %20이나 %2F 같은 문자열이 있는 이유
URL은 특정 문자만 안전하게 사용할 수 있습니다. 공백, 비영어 텍스트, 값 안의 슬래시, 기호, 예약 문자는 URL에 넣기 전에 퍼센트 인코딩이 필요한 경우가 많습니다.
DevToolKits의 **URL 인코더·디코더**는 읽을 수 있는 텍스트를 URL에 안전한 문자열로 변환하고, 기존 값을 다시 텍스트로 디코딩해 줍니다.
예시: 검색 키워드를 URL에 넣기
검색 키워드 Tokyo Station cafe를 URL에 넣고 싶다고 합시다. 공백은 환경에 따라 표시나 복사 시 깨질 수 있습니다.
Tokyo Station cafeURL 인코딩하면 다음과 같이 됩니다.
Tokyo%20Station%20cafe쿼리 파라미터에 넣으면 공유하기 좋은 URL이 됩니다.
https://example.com/search?q=Tokyo%20Station%20cafe원래 문자열로 디코딩되는지 확인해 두면 검색 조건이 잘못되거나 문자가 깨지는 것을 발견하기 쉽습니다.
인코딩이 중요한 경우
검색 URL, 콜백 URL, API 쿼리 파라미터, 리다이렉트 대상, 추적 링크를 만들 때 인코딩이 특히 중요합니다. 값이 올바르게 인코딩되지 않으면 브라우저나 서버가 엉뚱한 문자에서 분리해 다른 파라미터로 해석할 수 있습니다.
예를 들어 공백은 문맥에 따라 %20이나 +로 나타날 수 있습니다. 쿼리 값 안의 슬래시는 경로의 슬래시와 다르게 처리해야 할 수 있습니다.
쿼리 문자열은 따로 확인하기
URL에 파라미터가 많을 때는 **URL 파라미터 JSON 변환 도구**로 쿼리 문자열을 키와 값으로 분해하세요. 공유하거나 배포하기 전에 추적 링크와 API 요청을 훨씬 검토하기 쉬워집니다.
요약
URL 인코딩은 작은 디테일이지만 링크 깨짐, 잘못된 API 요청, 추적 오류를 막아줍니다. 받는 것은 디코딩하고, 보내는 것은 인코딩하며, 긴 쿼리 문자열은 가능한 한 구조화된 데이터로 검토하세요.
자주 묻는 질문
%20과 +는 둘 다 공백인가요?
둘 다 공백을 나타내지만 문맥이 다릅니다. URL 경로와 퍼센트 인코딩에서는 공백이 %20입니다. 쿼리 문자열(application/x-www-form-urlencoded)에서는 공백이 +로 표현될 수 있습니다. API나 폼이 기대하는 형식을 확인하고, URL 인코더·디코더로 실제로 보내는 문자열을 검증하세요.
이중 인코딩은 어떻게 알아보나요?
%는 값의 일부일 때 보통 %25로 인코딩됩니다. 디코딩 결과에 %25가 있거나, 한 번 디코딩해도 원래 URL로 돌아오지 않으면 이미 인코딩된 값을 다시 인코딩한 “이중 인코딩”일 가능성이 높습니다. 한 번 디코딩해 기대한 URL로 돌아오는지 확인하면 원인을 분리하기 쉽습니다.
URL의 비영어 문자는 항상 인코딩해야 하나요?
주소창에는 그대로 보일 수도 있지만, 링크로 공유하거나 API에 전달할 때는 환경에 따른 깨짐을 막기 위해 인코딩하세요. 예를 들어 東京은 UTF-8 바이트열인 %E6%9D%B1%E4%BA%AC로 인코딩됩니다.