쿼리 문자열 생성기

=

키-값 쌍의 목록에서 올바르게 인코딩된 쿼리 문자열을 구성합니다. 빌더는 예약된 문자, 공백 및 비-ASCII 입력을 RFC 3986이 요구하는 방식으로 처리하므로, 결과를 앰퍼샌드 또는 등호가 잘못 표시되지 않도록 URL에 그대로 삽입할 수 있습니다.

쿼리 문자열을 구성하는 방법

  1. 1

    키-값 쌍을 추가하세요

    각 매개변수 이름과 값을 입력하세요. 추가 키를 위해 더 많은 행을 추가할 수 있습니다.

  2. 2

    인코딩을 수행하세요.

    공백은 ‘%20’으로, 비ASCII 문자는 UTF-8 퍼센트 인코딩으로 변환되며 ‘&’, ‘=’, ‘#’, ‘?’ 같은 예약 문자도 안전하게 인코딩됩니다.

  3. 3

    출력을 복사하세요

    URL 앞에 ?를 붙이거나 Postman, curl 또는 fetch() 호출에 직접 붙여넣어 주세요.

무엇이 인코딩되는가

RFC 3986에 따르면, 예약되지 않은 세트(A-Z a-z 0-9 - _ . ~) 외의 모든 값은 쿼리 구성 요소 내에서 백분율 인코딩을 받아야 합니다. 실제로는 다음과 같은 의미입니다:

문자 인코딩 방식 이유
공간 %20 또는 + 맥락에 따라 의미가 불확실합니다
& %26 쌍을 분리하며 문자열을 파괴합니다
= %3D 키와 값을 분리합니다
# %23 프래그먼트를 시작합니다
? %3F 쿼리를 직접 실행합니다
/ %2F 경로는 안전하지만 가치는 위험하다

반복 키

각 행은 따로 인코딩되며 입력 순서가 유지됩니다. tag를 두 번 입력하면 tag=a&tag=b가 됩니다. 서버가 대괄호 표기를 요구한다면 키에 tag[]를 입력하세요. 도구는 프레임워크의 규칙을 추측하지 않습니다.

  • 사용자가 제공한 값은 항상 인코딩해야 하며, 절대 그 값을 원시 형태로 URL에 연결해서는 안 됩니다.
  • 값이 이진 형태로 보일 경우, 입력하기 전에 base64url로 인코딩하세요.

자주 묻는 질문

빌더는 RFC 3986에 따라 공백을 항상 %20으로 출력합니다. 파서는 폼 호환성을 위해 +도 공백으로 해석합니다.

키를 반복하세요: tags=php&tags=laravel. 일부 프레임워크에서는 tags[]=php&tags[]=laravel와 같은 괄호 표기법을 기대합니다. 백엔드 시스템이 파싱하는 방식과 일치시켜 주세요.

이는 쿼리 문자열 자체가 아니라 템플릿 엔진에서 적용하는 HTML 엔티티 인코딩입니다. href 내에서 렌더링할 때 출력 결과를 이중 에스케이핑하지 않는지 반드시 확인하십시오.

실제 길이 제한은 브라우저, 프록시, CDN, 서버마다 다릅니다. 큰 데이터는 요청 본문으로 보내세요.

관련 도구

이 도구는 다른 언어로도 제공됩니다