How to Build a REST API with Node and Express From Scratch

Learning how to build a rest api using Node.js and Express is a cornerstone skill for modern full-stack engineering. A Representational State Transfer (REST) API acts as the primary data highway connecting frontend client interfaces to underlying database layers. By establishing structural HTTP routing endpoints, your backend application can securely receive requests, process logic parameters, and return uniform JSON payloads.

Express remains the industry-standard routing framework for Node due to its lightweight architectural layer, minimal performance footprint, and flexible middleware pattern execution.

To see how secure operational keys are injected dynamically into your server logic during initialization, read our comprehensive Node Environment Variables Guide.

1. Basic Initialization and Package Setup

Before establishing your server routes, initialize a fresh Node configuration context and download the required Express dependencies using your terminal:

Bash

npm init -y
npm install express

Create a server entry script named exactly app.js at the root of your project directory structure.

2. Crafting the Core Express Server Shell

Open your script file and instantiate the foundational server engine block:

JavaScript

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

// Crucial Middleware to parse incoming JSON request body structures
app.use(express.json());

const PORT = 3000;
app.listen(PORT, () => {
    console.log(`REST API server running successfully on port: ${PORT}`);
});

3. Implementing CRUD Routing Layouts

A standard RESTful API maps database operations to specific HTTP methods: GET (Read), POST (Create), PUT (Update), and DELETE (Destroy).

Here is the exact code architecture to implement a clean mock database routing array layout inside your application script:

JavaScript

// In-memory mock data store
let users = [
    { id: 1, name: 'Alice' },
    { id: 2, name: 'Bob' }
];

// GET: Retrieve the complete collection listing
app.get('/api/users', (req, res) => {
    res.status(200).json(users);
});

// GET: Retrieve a single entity by its ID parameter node
app.get('/api/users/:id', (req, res) => {
    const user = users.find(u => u.id === parseInt(req.params.id));
    if (!user) return res.status(404).json({ error: 'Target user resource not found.' });
    res.status(200).json(user);
});

// POST: Create a brand new record entity safely
app.post('/api/users', (req, res) => {
    if (!req.body.name) return res.status(400).json({ error: 'Name field property is required.' });
    
    const newUser = {
        id: users.length + 1,
        name: req.body.name
    };
    users.push(newUser);
    res.status(201).json(newUser);
});

// PUT: Modify an existing record in-place
app.put('/api/users/:id', (req, res) => {
    const user = users.find(u => u.id === parseInt(req.params.id));
    if (!user) return res.status(404).json({ error: 'Target user resource not found.' });
    
    user.name = req.body.name;
    res.status(200).json(user);
});

// DELETE: Terminate an active resource from the data index
app.delete('/api/users/:id', (req, res) => {
    const userIndex = users.findIndex(u => u.id === parseInt(req.params.id));
    if (userIndex === -1) return res.status(404).json({ error: 'Target user resource not found.' });
    
    const deletedUser = users.splice(userIndex, 1);
    res.status(200).json(deletedUser[0]);
});

To review additional advanced configuration strategies regarding modular path routers, consult the official guide on the Express.js Routing Reference Documentation.