Colin's Blog
[nodejs] REST API를 위한 요청 파라미터 처리

REST(Representational State Transfer) API에서 사용되는 요청 파라미터 처리는 매우 중요합니다. 이번 블로그에서는 Node.js를 사용하여 REST API를 개발하는 중에 클라이언트가 보낸 요청 파라미터를 어떻게 처리하고 활용할 수 있는지 알아보겠습니다.

쿼리 파라미터 처리

클라이언트가 URL에 포함시킨 쿼리 파라미터는 req.query 객체를 통해 간단히 접근할 수 있습니다. 이 객체는 키-값 쌍으로 쿼리 파라미터를 담고 있어, REST API에서 필요한 파라미터 값을 쉽게 추출할 수 있습니다.

router.get('/users', (req, res) => {
  const { page, limit } = req.query;
  // page와 limit 값을 활용한 로직 처리
});

URL 파라미터 처리

URL 자체에 파라미터를 넣어 요청을 보내는 경우, 해당 파라미터는 req.params를 통해 접근할 수 있습니다. 이 방식은 주로 RESTful API에서 리소스 식별자를 전달할 때 사용됩니다.

router.get('/users/:id', (req, res) => {
  const userId = req.params.id;
  // userId를 활용한 특정 사용자 조회 로직 처리
});

요청 본문 파라미터 처리

클라이언트가 POST나 PUT 요청을 보낼 때, 파라미터를 요청 본문에 담아 전송할 수 있습니다. 이 경우 req.body를 통해 해당 파라미터에 접근할 수 있습니다.

router.post('/users', (req, res) => {
  const { name, email } = req.body;
  // name과 email 값을 활용한 신규 사용자 생성 로직 처리
});

종합

Node.js의 Express 프레임워크를 사용하여 REST API를 개발할 때, 요청 파라미터를 쿼리, URL, 본문에서 어떻게 처리하는지에 대해 알아보았습니다. 요청 파라미터 처리는 API의 안정성과 보안을 담보하기 위해 꼭 숙지해야 하는 부분이니, 신경써서 개발에 착수해야 합니다.

이상으로, REST API를 위한 요청 파라미터 처리에 대한 내용을 마치도록 하겠습니다.

참고 문헌:

© 2018 Colin. All rights reserved.