はじめに

近年、ウェブ開発においてREST APIは欠かせない要素となっています。Node.jsは非同期I/Oを得意とするため、高性能なAPIサーバーを構築するのに適しています。本記事では、Node.jsとExpressを使用してシンプルなREST APIを構築する方法を解説します。

環境設定

Node.js：最新版（公式サイトからインストール）
テキストエディタ：Visual Studio Codeなど
APIテストツール：Postman、curl、またはブラウザの拡張機能

プロジェクトの初期化

まず、新しいプロジェクト用のディレクトリを作成し、npm initで初期化します。

mkdir simple-rest-api
cd simple-rest-api
npm init -y

Expressの導入と基本設定

ExpressはNode.js用の軽量なウェブフレームワークです。下記の流れで導入を進めます。

インストール

npm install express

基本的なサーバーの設定

index.jsというファイルを作成し、以下のコードを追加します。

const express = require('express');
const app = express();
const port = 3000;

// JSONデータを扱うためのミドルウェア
app.use(express.json());

app.listen(port, () => {
  console.log(`Server is running on http://localhost:${port}`);
});

RESTfulルートの作成

基本的なCRUD（Create, Read, Update, Delete）操作を行うためのルートを設定します。

データの管理（モックデータ）

実際のデータベースを使用せず、モックデータを配列で管理します。

let users = [
  { id: 1, name: '太郎' },
  { id: 2, name: '花子' },
];

CRUD操作の実装

1. データの取得（Read）

全ユーザーを取得

app.get('/users', (req, res) => {
  res.json(users);
});

特定のユーザーを取得

app.get('/users/:id', (req, res) => {
  const id = Number(req.params.id);
  const user = users.find(u => u.id === id);
  if (user) {
    res.json(user);
  } else {
    res.status(404).send('ユーザーが見つかりません');
  }
});

2. データの追加（Create）

app.post('/users', (req, res) => {
  const newUser = {
    id: users.length + 1,
    name: req.body.name,
  };
  users.push(newUser);
  res.status(201).json(newUser);
});

3. データの更新（Update）

app.put('/users/:id', (req, res) => {
  const id = Number(req.params.id);
  const user = users.find(u => u.id === id);
  if (user) {
    user.name = req.body.name || user.name;
    res.json(user);
  } else {
    res.status(404).send('ユーザーが見つかりません');
  }
});

4. データの削除（Delete）

app.delete('/users/:id', (req, res) => {
  const id = Number(req.params.id);
  users = users.filter(u => u.id !== id);
  res.status(204).send();
});

サーバーの起動とテスト

サーバーの起動

node index.js

ブラウザまたはAPIテストツールで以下のURLにアクセスして動作を確認します。

全ユーザー取得：GET http://localhost:3000/users
ユーザー取得：GET http://localhost:3000/users/1
ユーザー追加：POST http://localhost:3000/users（ボディに{"name": "新しいユーザー"}）
ユーザー更新：PUT http://localhost:3000/users/1（ボディに{"name": "更新されたユーザー"}）
ユーザー削除：DELETE http://localhost:3000/users/1

次のステップ

下記のようなアップデート案が考えられるかと思います。

データベースの導入：MySQLやMongoDBなどのデータベースを接続して、永続的なデータ管理を実現
エラーハンドリング：エラー時の応答を統一し、APIの信頼性を向上
認証と認可：JWTなどを使用してセキュアなAPIに拡張
APIドキュメンテーション：Swaggerなどのツールを使って、自動的にAPIドキュメントを生成

まとめ

今回の記事では、Node.jsとExpressを使ってシンプルなREST APIを構築する方法を紹介しました。基本的なCRUD操作を実装することで、RESTful APIの基礎を理解できたかと思います。次のステップでは、データベースの導入やセキュリティ強化など、実践的な機能追加に挑戦してみてください。

お問い合わせやご意見がありましたら、お気軽にご連絡ください。

おわりに

弊社では、フリーランスエンジニアの方を募集しております！
熱意を持って新しいプロジェクトに挑戦したい方、様々な大規模開発プロジェクトに興味のある方は、下記フォームにてあなたの経歴をご回答ください！
👉 フォームはこちら
たくさんのご応募、お待ちしております！