🤖 Node.js로 나만의 REST API 만들기

“백엔드 개발, 어디서부터 시작해야 하지?”
처음 접하는 분들에게 Node.js는 훌륭한 선택입니다. 자바스크립트 하나로 프론트엔드와 백엔드를 모두 다룰 수 있고, 가볍고 빠른 서버를 쉽게 만들 수 있기 때문입니다.

이번 튜토리얼에서는 할 일(To-do) 관리 API를 직접 만들어보며 REST API의 기초를 익혀봅시다.

---

1단계 👉🏻 프로젝트 초기화

먼저 프로젝트 폴더를 만들고 Node.js 환경을 설정합니다.

mkdir node-api-tutorial
cd node-api-tutorial
npm init -y
npm install express

• npm init -y: 기본 package.json 생성
• npm install express: 서버 구축을 위한 Express.js 설치

---

2단계 👉🏻 서버 실행하기

index.js 파일을 만들고 간단한 서버를 띄워봅니다.

const express = require("express");
const app = express();
const PORT = 3000;

app.use(express.json());

app.get("/", (req, res) => {
  res.send("Hello Node.js API!");
});

app.listen(PORT, () => {
  console.log(`🚀 Server running at http://localhost:${PORT}`);
});

• 이제 터미널에서 node index.js 실행 후 브라우저에서 http://localhost:3000 에 접속하면 메시지를 확인할 수 있습니다.

---

3단계 👉🏻 To-do API 만들기

이제 본격적으로 API 엔드포인트를 작성해봅시다.

let todos = [];

// 목록 조회
app.get("/todos", (req, res) => {
  res.json(todos);
});

// 추가
app.post("/todos", (req, res) => {
  const { task } = req.body;
  const newTodo = { id: Date.now(), task, done: false };
  todos.push(newTodo);
  res.status(201).json(newTodo);
});

// 완료 처리
app.patch("/todos/:id", (req, res) => {
  const { id } = req.params;
  const todo = todos.find((t) => t.id == id);
  if (!todo) return res.status(404).json({ message: "Not found" });

  todo.done = true;
  res.json(todo);
});

// 삭제
app.delete("/todos/:id", (req, res) => {
  const { id } = req.params;
  todos = todos.filter((t) => t.id != id);
  res.json({ message: "Deleted" });
});

---

4단계 👉🏻 테스트하기

Postman이나 cURL을 사용해 요청을 보낼 수 있습니다.

• GET /todos → 전체 목록 조회
• POST /todos → { "task": "블로그 작성" } 추가
• PATCH /todos/:id → 특정 항목 완료
• DELETE /todos/:id → 특정 항목 삭제

---

💡 마무리

이렇게 간단한 To-do API 서버를 완성했습니다.
실제 서비스에선 데이터베이스 연결, 에러 처리, 인증/인가(JWT) 등을 추가하면 훨씬 완성도 있는 서버가 됩니다.