URL 빌더
기본 URL에 경로 파라미터와 쿼리 파라미터 JSON을 넣어 완성된 URL을 만듭니다.
입력
https://…처럼 스킴이 있는 절대 URL을 입력하세요. 경로 파라미터 자리는 {name} 또는 :name으로 표시합니다. URL에 이미 있는 쿼리 파라미터와 #해시는 그대로 둡니다.
키와 이름이 같은 자리표시자에 값을 넣습니다. 값은 문자열·숫자·불리언만 쓸 수 있습니다.
각 키가 쿼리 파라미터가 됩니다. 기본 URL에 같은 이름의 파라미터가 있으면 JSON 값으로 바꿉니다.
URL은 이 브라우저에서 조합합니다. 완성된 URL을 열거나 요청을 보내지 않습니다.
쿼리 형식
null 값과 빈 배열·빈 객체는 생략합니다. 객체나 배열이 들어 있는 배열은 항상 인덱스 형식으로 만듭니다. 키의 대괄호는 %5B, %5D로 인코딩하며 숫자는 입력한 표기 그대로 씁니다.
완성된 URL
기본 URL을 입력하면 완성된 URL이 나타납니다.
URL 빌더 사용 가이드
기본 URL에 경로 파라미터와 쿼리 파라미터 JSON을 합쳐 완성된 URL을 만듭니다.
기본 URL에 {name} 또는 :name으로 경로 자리를 표시하고, 경로 JSON에는 그 값을, 쿼리 JSON에는 쿼리 파라미터를 적으세요. 배열·중첩 객체·공백을 어떤 형식으로 쓸지도 고를 수 있습니다.
완성된 URL을 API 요청, 테스트 링크, 문서 예제에 복사해 쓰세요. 파라미터 표에서 디코딩한 키와 값을 확인할 수 있습니다.
계산·렌더링은 이 브라우저 탭에서 처리합니다. 복사·다운로드·공유를 하면 선택한 결과가 탭 밖에서도 사용될 수 있습니다.
따라 해 보기
- 입력·설정
- https://api.example.com/users/{userId}/posts?sort=desc, 경로 {"userId": 42}, 쿼리 {"page": 2, "tags": ["a", "b"]}
- 동작
- 기본값(배열 반복 형식)으로 만들기
- 결과
- https://api.example.com/users/42/posts?sort=desc&page=2&tags=a&tags=b
지원 범위와 주의점
- 기본 URL은 https://처럼 스킴이 있는 절대 URL이어야 합니다. 경로 값은 비어 있지 않은 문자열·숫자·불리언이어야 하며 경로 한 칸으로 인코딩하므로 슬래시는 %2F가 됩니다.
- null 값과 빈 배열·빈 객체는 생략하고, 빈 문자열은 key=로 만듭니다. JSON 키는 기본 URL의 같은 키를 대체하며, 숫자는 큰 정수를 포함해 입력한 표기 그대로 씁니다.
- 결과는 브라우저 URL 표준에 맞게 정규화합니다. 예를 들어 국제화 도메인은 퓨니코드로 바뀌고 기본 포트는 생략됩니다.
자주 묻는 질문
- 배열 형식은 무엇을 골라야 하나요?
- 서버가 해석하는 형식을 고르세요. 반복은 Spring·FastAPI 같은 여러 프레임워크에서, 대괄호는 PHP·Rails·qs 기반 파서에서, 인덱스는 PHP·qs에서 쓰입니다. 쉼표는 값 하나를 나눠 읽는 API에 맞습니다.
계정·동기화·광고·분석의 데이터 흐름은 개인정보처리방침에서 확인하세요.