Why REST design principles matter in Node.js - See It in Action

Why REST Design Principles Matter

📖 Scenario: You are building a simple Node.js server that follows REST design principles to manage a list of books. This server will help clients get book data in a clear and predictable way.

🎯 Goal: Create a basic RESTful API using Node.js that handles book data with proper REST design principles like using correct HTTP methods and clear URL paths.

📋 What You'll Learn

Create an array called books with three book objects, each having id, title, and author properties

Create a variable called port set to 3000

Create a GET route /books that returns the list of books

Create a POST route /books that adds a new book to the books array

💡 Why This Matters

🌍 Real World

REST APIs are used everywhere to let different software talk to each other clearly and predictably, like mobile apps getting data from servers.

💼 Career

Understanding REST design principles is essential for backend developers and full-stack developers to build APIs that others can easily use and maintain.

1

DATA SETUP: Create the initial books array

Create an array called books with these exact three objects: { id: 1, title: '1984', author: 'George Orwell' }, { id: 2, title: 'To Kill a Mockingbird', author: 'Harper Lee' }, and { id: 3, title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' }.

Node.js

// Your code here

Need a hint?

Use const books = [ ... ] with three objects inside.

2

CONFIGURATION: Set the server port

Create a variable called port and set it to 3000.

Node.js

const books = [
  { id: 1, title: '1984', author: 'George Orwell' },
  { id: 2, title: 'To Kill a Mockingbird', author: 'Harper Lee' },
  { id: 3, title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' }
];

// Your code here

Need a hint?

Use const port = 3000; to set the port.

3

CORE LOGIC: Create a GET route to return books

Using Express, create a GET route at /books that sends the books array as JSON response. Use app.get('/books', (req, res) => { ... }) and res.json(books) inside the route.

Node.js

const books = [
  { id: 1, title: '1984', author: 'George Orwell' },
  { id: 2, title: 'To Kill a Mockingbird', author: 'Harper Lee' },
  { id: 3, title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' }
];

const port = 3000;

const express = require('express');
const app = express();
app.use(express.json());

// Your code here

Need a hint?

Use app.get('/books', (req, res) => { res.json(books); }) to create the GET route.

4

COMPLETION: Create a POST route to add a new book

Create a POST route at /books using app.post('/books', (req, res) => { ... }). Inside, add the new book from req.body to the books array, then respond with the added book using res.status(201).json(newBook). Finally, start the server with app.listen(port).

Node.js

const books = [
  { id: 1, title: '1984', author: 'George Orwell' },
  { id: 2, title: 'To Kill a Mockingbird', author: 'Harper Lee' },
  { id: 3, title: 'The Great Gatsby', author: 'F. Scott Fitzgerald' }
];

const port = 3000;

const express = require('express');
const app = express();
app.use(express.json());

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

// Your code here

Need a hint?

Use app.post('/books', (req, res) => { ... }) to add the book and app.listen(port) to start the server.