쿼리 파라미터와 패스 파라미터

패스 파라미터(Path Parameter)와 쿼리 파라미터(Query Parameter)는 HTTP 요청에서 서버에 데이터를 전달하는 두 가지 방식이다.

 

1. 패스 파라미터 (Path Parameter)

• URL 경로 자체에 포함되는 값
• 특정 리소스(자원)를 식별할 때

GET /users/123 // 123이 패스 파라미터다

 

Spring 예시

@GetMapping("/users/{id}")
fun getUser(@PathVariable id: Long): UserResponse {
    ...
}

 

 

2. 쿼리 파라미터 (Query Parameter)

• URL의 ? 이후에 key=value 형태로 붙는 값
• 필터링, 정렬, 검색 조건 등 리소스를 세부적으로 조회하거나 옵션을 줄 때 사용

예시:

GET /users?age=20&sort=desc

 

 

Spring 예시

@GetMapping("/users")
fun getUsers(
    @RequestParam age: Int?,
    @RequestParam sort: String?
): List<UserResponse> {
    ...
}

 

	패스파라미터	쿼리파라미터
	@PathVariable	@RequestParam
의미	리소스의 식별자	조회 조건, 옵션
예시	/posts/10/comments	/posts?category=travel&limit=5