Guide

URL 쿼리 생성기 사용 흐름

키-값 쌍을 안전하게 인코딩해 검색 URL, 공유 링크, API 테스트용 쿼리 문자열을 만듭니다.

인코딩 실수 줄이기

공백, 한글, 특수문자가 들어간 값을 직접 이어 붙이지 않고 브라우저 URL 규칙에 맞게 인코딩합니다.

테스트 링크 조립

필터, 페이지 번호, 정렬 값처럼 여러 파라미터를 한 화면에서 조립해 API나 화면 링크를 재현합니다.

복사 전 검토

최종 URL을 복사하기 전에 누락된 필수 파라미터와 빈 값이 있는지 확인합니다.

Workflow

사용 순서

  1. 기준 URL을 입력하거나 쿼리 문자열만 만들 준비를 합니다.
  2. 파라미터 이름과 값을 행 단위로 추가합니다.
  3. 생성된 URL에서 인코딩된 값과 구분자가 올바른지 확인합니다.
  4. 분석 도구나 API 테스트에 붙여 넣기 전 불필요한 빈 값을 제거합니다.

Examples

실제 입력과 결과

기본 파라미터 조합

입력

base   https://api.example.com/search
q      개발자 도구
page   2

결과

https://api.example.com/search?q=%EA%B0%9C%EB%B0%9C%EC%9E%90%20%EB%8F%84%EA%B5%AC&page=2

특수문자가 든 값

입력

redirect  https://example.com/back?id=1&t=2

결과

redirect=https%3A%2F%2Fexample.com%2Fback%3Fid%3D1%26t%3D2

값 안의 &와 =까지 인코딩해야 파라미터가 끊기지 않습니다.

Troubleshooting

자주 만나는 오류

공백이 +인지 %20인지

쿼리 문자열에서는 둘 다 공백으로 해석되는 것이 보통이지만, 경로(path)에서는 +가 문자 그대로 플러스입니다. 서버 구현에 따라 다르게 받으므로 %20이 안전합니다.

배열 파라미터 표기

tags=a&tags=b, tags[]=a&tags[]=b, tags=a,b 세 가지가 모두 쓰입니다. 어느 것을 받는지는 서버 프레임워크에 달렸으니 API 문서를 먼저 확인하세요.

Review

확인할 점

중복 키 처리

같은 키를 여러 번 쓰는 방식은 서버 구현마다 다르게 해석될 수 있습니다. 배열 파라미터 규칙을 API 문서와 맞추세요.

민감 정보 주의

URL은 브라우저 기록, 로그, 공유 미리보기 등에 남을 수 있습니다. 토큰이나 개인정보를 쿼리에 넣지 않는 편이 좋습니다.

Related

함께 쓰면 좋은 도구