가이드

URL 구성 요소로 URL 만드는 방법

스킴, 호스트, 포트, 경로와 선택 항목을 입력하면 URL 구성 결과를 확인할 수 있습니다. 네트워크 접근이 아니라 구성 요소 조합과 쿼리 해석을 살펴보는 도구입니다.

도구 URL 빌더

먼저 살펴볼 구성 요소

이 도구는 여러 구성 요소를 조합해 하나의 URL 결과를 만드는 데 사용합니다. 스킴, 호스트, 포트, 경로, 파라미터, 쿼리, 프래그먼트를 각각 살펴보면서 입력값이 결과에 어떤 형태로 반영되는지 확인할 수 있습니다. 주소를 새로 정리하거나 문서에 넣을 값을 준비할 때 적합합니다. 네트워크 접근 없이 주소 구성을 확인하는 용도이므로, 만들어진 결과를 실제 주소의 작동 여부를 판단하는 값으로 해석하면 안 됩니다.

먼저 스킴과 호스트를 정하면 결과의 기본 뼈대가 잡힙니다. 스킴 선택지는 httpshttp이며, 처음에는 https가 선택됩니다. 호스트를 따로 바꾸지 않으면 example.com이 사용됩니다. 포트는 기본값이 0이므로 일반적인 기본 입력에서는 호스트 뒤에 별도 포트가 나타나지 않습니다. 경로의 기본값은 /입니다.

나머지 입력은 필요한 경우에만 조정하면 됩니다. 파라미터와 프래그먼트는 빈 텍스트로 시작하고, 쿼리는 기본 문구가 들어 있는 상태로 시작합니다. 쿼리는 결과의 한 영역으로 반영될 뿐 아니라 구조화된 쿼리 매개변수 정보로도 해석됩니다. 따라서 주소 모양과 쿼리 항목을 함께 살펴보려는 상황에서 입력 전후의 차이를 비교하기 좋습니다.

입력값을 순서대로 조합하기

  1. 스킴 선택 영역에서 https 또는 http를 고릅니다. 선택을 바꾸지 않으면 기본 스킴인 https가 유지됩니다.
  2. 호스트 입력란에 사용할 호스트를 적습니다. 값을 비워 둔 경우의 기본 호스트는 example.com입니다.
  3. 포트가 필요한지 정합니다. 기본 포트 값은 0이며, 입력한 값이 0보다 큰 정수로 변환될 때에만 호스트 뒤에 포트가 포함됩니다. 8080을 넣으면 localhost:8080과 같은 부분이 결과에 나타날 수 있습니다.
  4. 경로를 입력합니다. 아무것도 바꾸지 않으면 /가 사용됩니다. api/users처럼 첫 문자에 /가 없는 값을 입력해도 구성 과정에서 앞에 /가 보완됩니다.
  5. 필요할 때 파라미터와 프래그먼트를 입력합니다. 두 항목은 기본적으로 빈 텍스트이므로, 사용하지 않는다면 그대로 두어도 됩니다.
  6. 쿼리를 입력하거나 기본값을 유지합니다. 기본 쿼리는 key=value&lang=en이며, 입력한 쿼리는 만들어진 URL에 반영됩니다.
  7. 결과 영역에서 구성된 주소와 쿼리 매개변수 정보를 함께 확인합니다. 구성 요소를 하나만 바꾼 뒤 다시 살펴보면 어느 입력이 결과에 영향을 주었는지 비교하기 쉽습니다.
  8. 마지막으로 결과의 스킴, 호스트, 포트, 경로 순서를 확인합니다. 이 확인은 입력 조합을 검토하는 절차이며, 주소가 실제로 유효한지 판단하는 절차는 아닙니다.

표시된 결과를 해석하는 기준

결과는 선택하거나 입력한 구성 요소가 이어진 URL 형태로 보입니다. 기본값을 그대로 사용하면 기본 스킴, 기본 호스트, 기본 경로, 기본 쿼리가 결합된 결과가 표시됩니다. 이때 포트 값은 0이므로 호스트 뒤에 포트 표기가 추가되지 않습니다. 파라미터와 프래그먼트도 빈 상태라면 해당 부분에 별도 텍스트가 나타나지 않습니다.

호스트나 경로를 바꾸면 변경한 값이 결과에 반영됩니다. 경로에 선행 슬래시가 빠진 입력을 사용했다면 결과에서는 앞에 슬래시가 보완된 형태를 확인할 수 있습니다. 0보다 큰 정수로 변환되는 포트를 입력한 경우에는 호스트와 경로 사이에 콜론과 포트 값이 포함됩니다. 포트 입력의 표시 여부는 단순히 글자가 입력되었는지가 아니라 변환된 값의 조건에 따라 달라집니다.

쿼리 결과는 두 방향으로 확인합니다. 첫째, 구성된 URL 안에서 쿼리 영역이 어떻게 나타나는지 봅니다. 둘째, 같은 텍스트가 구조화된 쿼리 매개변수 정보로 어떻게 해석되는지 살핍니다. 그러나 표시된 결과만으로 입력의 유효성, 인코딩 상태, 실제 접근 가능성, 변환 전후의 동일성을 확정할 수는 없습니다. 필요한 판단은 사용 목적에 맞는 별도 기준으로 진행해야 합니다.

사용 예시

기본 설정으로 주소 구성을 확인하려는 사용자가 값을 별도로 바꾸지 않고 결과 영역을 검토합니다.

모든 입력을 처음 상태로 둔 뒤 결과를 확인하고, 표시된 주소의 구성 순서와 쿼리 매개변수 정보를 서로 대조합니다.

기본 스킴과 호스트, 기본 경로, 기본 쿼리가 결합된 URL 형태가 표시되며 쿼리는 구조화된 매개변수 정보로도 해석됩니다.

제한 사항

  • 구성 결과와 쿼리 정보는 입력 조합을 보여 주지만, 입력의 유효성, 인코딩 상태, 실제 접근 가능성, 변환 전후의 동일성을 확인해 주지는 않습니다.

자주 발생하는 오류

  • 경로를 api/users처럼 입력한 뒤 슬래시가 없어 잘못되었다고 판단하는 경우가 있습니다. 앞에 슬래시가 없는 경로에는 구성 과정에서 슬래시가 보완되므로, 결과에 /api/users처럼 반영되었는지 먼저 확인하세요.

자주 묻는 질문

값을 입력하지 않아도 기본 결과를 볼 수 있나요?

기본값을 바꾸지 않으면 기본 스킴인 https, 기본 호스트인 example.com, 기본 포트 0, 기본 경로 /가 사용됩니다. 쿼리도 기본값으로 남아 기본 조합 결과가 표시됩니다.

포트는 어떤 조건에서 결과에 포함되나요?

포트 입력값이 0보다 큰 정수로 변환될 때 호스트 뒤에 포트가 포함됩니다. 8080처럼 양의 정수를 입력한 경우에는 결과에서 콜론 뒤의 포트 부분을 확인할 수 있습니다.

쿼리를 입력하면 어떤 결과를 확인하나요?

쿼리는 구성된 URL의 쿼리 영역에 반영되며, 별도로 구조화된 쿼리 매개변수 정보로도 해석됩니다. 그 정보만으로 입력의 유효성이나 실제 접근 가능성을 판단할 수는 없습니다.

도구

URL 빌더