Node.js API Guide 07 — Bonus: 미션 해설로 CRUD 완성 (PATCH/DELETE) | 0xccffff Log

07 — 보너스 트랙: 미션 해설로 CRUD 완성 (PATCH/DELETE)#

이 글은 05편까지 만든 TODO API를 미션 해설 형태로 마무리하는 보너스 트랙입니다.
PATCH(수정)와 DELETE(삭제)를 붙이면, 우리가 만든 서버는 CRUD를 전부 갖추게 됩니다.

Note

CRUD는 보통 이렇게 묶어서 부릅니다.

Create: 만들기 → POST /todos
Read: 읽기 → GET /todos
Update: 수정 → PATCH /todos/:id
Delete: 삭제 → DELETE /todos/:id

Prerequisites

05편 완료 (검증/에러 처리/간단 인증까지 된 상태)
작업 폴더: C:\Workspace\node-api
Windows Terminal 기본 셸: PowerShell

0) 실습 준비 (이전 편과 동일)#

VS Code → File > Open Folder... → C:\Workspace\node-api
VS Code → Terminal > New Terminal
서버 실행:

node server.js

// 새로 추가된 부분: PATCH /todos/:id - done 수정
app.patch("/todos/:id", requireApiKey, (req, res) => {
  // 1) URL의 :id 읽기 (문자열 → 숫자)
  const id = parseInt(req.params.id, 10);
  if (Number.isNaN(id)) {
    return fail(res, 400, "invalid_id", { example: "/todos/1" });
  }
 
  // 2) 대상 TODO 찾기
  const todo = todos.find((t) => t.id === id);
  if (!todo) {
    return fail(res, 404, "todo_not_found", { id });
  }
 
  // 3) done 값 적용 (true/false)
  const done = req.body?.done;
 
  // done이 없으면 토글(반전), 있으면 그 값대로 설정
  if (done === undefined) {
    todo.done = !todo.done;
  } else if (typeof done === "boolean") {
    todo.done = done;
  } else {
    return fail(res, 400, "done must be boolean", { example: { done: true } });
  }
 
  // 4) 파일 저장
  saveTodosToFile(todos);
 
  return res.json({ ok: true, item: todo });
});

// 새로 추가된 부분: DELETE /todos/:id - 삭제
app.delete("/todos/:id", requireApiKey, (req, res) => {
  const id = parseInt(req.params.id, 10);
  if (Number.isNaN(id)) {
    return fail(res, 400, "invalid_id", { example: "/todos/1" });
  }
 
  const index = todos.findIndex((t) => t.id === id);
  if (index === -1) {
    return fail(res, 404, "todo_not_found", { id });
  }
 
  const deleted = todos.splice(index, 1)[0];
 
  // 삭제도 저장해야 유지됩니다.
  saveTodosToFile(todos);
 
  return res.json({ ok: true, item: deleted });
});

Note

최종 확인용 전체 코드 (server.js)#

헷갈리면 아래 코드로 통째로 교체해도 됩니다. (붙여넣고 Ctrl + S 저장)

server.js

const express = require("express");
const fs = require("fs");
const path = require("path");
 
const app = express();
const PORT = 3000;
 
// JSON 본문(body) 파싱
app.use(express.json());
 
// (로컬 실습용) 간단 인증 키
const API_KEY = "dev-secret";
 
// todos.json 파일 경로 (server.js와 같은 폴더)
const DATA_PATH = path.join(__dirname, "todos.json");
 
function loadTodosFromFile() {
  if (!fs.existsSync(DATA_PATH)) return [];
  const raw = fs.readFileSync(DATA_PATH, "utf-8").trim();
  if (raw.length === 0) return [];
  const parsed = JSON.parse(raw);
  if (!Array.isArray(parsed)) {
    throw new Error("todos.json must be an array like []");
  }
  return parsed;
}
 
function saveTodosToFile(todos) {
  fs.writeFileSync(DATA_PATH, JSON.stringify(todos, null, 2), "utf-8");
}
 
function fail(res, status, error, extra) {
  const payload = { ok: false, error };
  if (extra && typeof extra === "object") {
    Object.assign(payload, extra);
  }
  return res.status(status).json(payload);
}
 
function requireApiKey(req, res, next) {
  const key = req.header("x-api-key");
  if (key !== API_KEY) {
    return fail(res, 401, "unauthorized", {
      hint: 'Set header "x-api-key" to the correct value',
    });
  }
  return next();
}
 
// 시작할 때 파일에서 읽어서 메모리로 올림
let todos = loadTodosFromFile();
 
// 저장된 TODO 중 가장 큰 id를 찾아서, 그 다음 번호부터 시작합니다.
let nextId = 1;
for (const t of todos) {
  if (typeof t.id === "number" && t.id >= nextId) {
    nextId = t.id + 1;
  }
}
 
app.get("/health", (req, res) => {
  res.json({ ok: true });
});
 
app.get("/todos", (req, res) => {
  res.json({ items: todos });
});
 
// POST /todos - 하나 추가 (인증 필요)
app.post("/todos", requireApiKey, (req, res) => {
  const title = req.body?.title;
 
  // 검증 1) 타입/빈 값
  if (typeof title !== "string" || title.trim().length === 0) {
    return fail(res, 400, "title is required", {
      example: { title: "물 마시기" },
    });
  }
 
  // 검증 2) 길이 제한
  if (title.trim().length > 100) {
    return fail(res, 400, "title is too long", { max: 100 });
  }
 
  const todo = {
    id: nextId++,
    title: title.trim(),
    done: false,
    createdAt: new Date().toISOString(),
  };
 
  todos.push(todo);
  saveTodosToFile(todos);
 
  res.status(201).json({ ok: true, item: todo });
});
 
// 새로 추가된 부분: PATCH /todos/:id - done 수정
app.patch("/todos/:id", requireApiKey, (req, res) => {
  const id = parseInt(req.params.id, 10);
  if (Number.isNaN(id)) {
    return fail(res, 400, "invalid_id", { example: "/todos/1" });
  }
 
  const todo = todos.find((t) => t.id === id);
  if (!todo) {
    return fail(res, 404, "todo_not_found", { id });
  }
 
  const done = req.body?.done;
 
  if (done === undefined) {
    todo.done = !todo.done;
  } else if (typeof done === "boolean") {
    todo.done = done;
  } else {
    return fail(res, 400, "done must be boolean", { example: { done: true } });
  }
 
  saveTodosToFile(todos);
 
  return res.json({ ok: true, item: todo });
});
 
// 새로 추가된 부분: DELETE /todos/:id - 삭제
app.delete("/todos/:id", requireApiKey, (req, res) => {
  const id = parseInt(req.params.id, 10);
  if (Number.isNaN(id)) {
    return fail(res, 400, "invalid_id", { example: "/todos/1" });
  }
 
  const index = todos.findIndex((t) => t.id === id);
  if (index === -1) {
    return fail(res, 404, "todo_not_found", { id });
  }
 
  const deleted = todos.splice(index, 1)[0];
  saveTodosToFile(todos);
 
  return res.json({ ok: true, item: deleted });
});
 
// (연습용) 강제로 에러를 내는 엔드포인트
app.get("/debug/error", (req, res) => {
  throw new Error("debug error");
});
 
// 404: 없는 주소는 여기로 떨어짐
app.use((req, res) => {
  return fail(res, 404, "not_found", { path: req.path });
});
 
// 500: 서버에서 예외가 터졌을 때
app.use((err, req, res, next) => {
  console.error(err);
 
  // JSON 파싱이 깨진 경우(잘못된 JSON)
  if (err instanceof SyntaxError) {
    return fail(res, 400, "invalid_json");
  }
 
  return fail(res, 500, "internal_error");
});
 
app.listen(PORT, () => {
  console.log(`Server running: http://localhost:${PORT}`);
});

$headers = @{ "x-api-key" = "dev-secret" }
$body    = @{ title = "PATCH/DELETE 테스트" } | ConvertTo-Json -Compress
 
Invoke-RestMethod -Method Post -Uri "http://localhost:3000/todos" `
  -ContentType "application/json; charset=utf-8" -Headers $headers -Body $body

$headers = @{ "x-api-key" = "dev-secret" }
$body    = @{ done = $true } | ConvertTo-Json -Compress
 
Invoke-RestMethod -Method Patch -Uri "http://localhost:3000/todos/1" `
  -ContentType "application/json; charset=utf-8" -Headers $headers -Body $body