REST API Design Made Simple with Express.js 🚀

---

📌 Introduction

Modern web applications are all about communication.

👉 Your frontend (React, mobile app, etc.) talks to your backend 👉 Backend sends data back

This communication happens through something called:

REST APIs

---

🧠 What is a REST API?

REST stands for:

👉 Representational State Transfer

But let’s keep it simple:

A REST API is a way for client and server to communicate using HTTP.

---

🧩 Simple Meaning:

• Client requests data 📱

• Server responds with data 🖥️

---

🌐 APIs in Simple Terms

👉 API = messenger between client and server

Example:

• You order food 🍔

• Waiter takes order

• Kitchen prepares food

• Waiter brings food

👉 Waiter = API

---

📦 What are Resources in REST?

In REST, everything is treated as a resource.

---

🧠 Example Resource:

👉 users

---

📌 Resource examples:

• users

• products

• orders

• posts

---

🔄 REST Architecture Concept

Client → HTTP Request → Server → Response

---

⚙️ HTTP Methods in REST API

Each operation uses a specific HTTP method.

---

📥 1. GET (Read Data)

👉 Used to fetch data

app.get("/users", (req, res) => {
  res.send("Get all users");
});

---

🧠 Example:

• Get all users

• Get user by ID

---

📤 2. POST (Create Data)

👉 Used to create new resource

app.post("/users", (req, res) => {
  res.send("Create user");
});

---

🧠 Example:

• Create new user

• Add product

---

🔄 3. PUT (Update Data)

👉 Used to update existing resource

app.put("/users/:id", (req, res) => {
  res.send("Update user");
});

---

🧠 Example:

• Update user profile

• Modify product details

---

❌ 4. DELETE (Remove Data)

👉 Used to delete resource

app.delete("/users/:id", (req, res) => {
  res.send("Delete user");
});

---

🧠 Example:

• Delete user account

• Remove product

---

📊 CRUD vs HTTP Methods

CRUD Operation	HTTP Method	Route Example
Create	POST	/users
Read	GET	/users
Update	PUT	/users/:id
Delete	DELETE	/users/:id

---

🔢 HTTP Status Codes (Basics)

Status codes tell what happened with a request.

---

🧠 Common Codes:

Code	Meaning
200	Success
201	Created
400	Bad Request
401	Unauthorized
404	Not Found
500	Server Error

---

🧩 Example:

res.status(201).send("User created");

---

🧭 Designing REST Routes (Best Practice)

Let’s take a users resource.

---

📌 Clean REST Routes:

GET     /users        → get all users
GET     /users/:id    → get single user
POST    /users        → create user
PUT     /users/:id    → update user
DELETE  /users/:id    → delete user

---

🧠 Why This Structure?

👉 Predictable 👉 Scalable 👉 Easy to maintain

---

🔄 REST Request-Response Flow

Client Request
      ↓
Route Handler (Express)
      ↓
Business Logic
      ↓
Database Operation
      ↓
Response Sent

---

🚀 Example Full Express REST API

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

app.use(express.json());

// GET all users
app.get("/users", (req, res) => {
  res.send("Get all users");
});

// GET single user
app.get("/users/:id", (req, res) => {
  res.send(`Get user ${req.params.id}`);
});

// POST create user
app.post("/users", (req, res) => {
  res.status(201).send("User created");
});

// PUT update user
app.put("/users/:id", (req, res) => {
  res.send("User updated");
});

// DELETE user
app.delete("/users/:id", (req, res) => {
  res.send("User deleted");
});

app.listen(3000);

---

🌍 Real-World Example

🛒 E-commerce API:

GET /products
POST /orders
PUT /orders/:id
DELETE /cart/:id

---

⚠️ Important REST Principles

• Use nouns, not verbs in routes

• Keep routes consistent

• Use correct HTTP methods

• Return proper status codes

---

🎯 Key Takeaways

• REST APIs enable client-server communication

• Resources represent data (users, products, etc.)

• HTTP methods define actions

• Status codes explain results

• Clean route design improves scalability

---

✍️ Practice Challenge

Try building:

👉 A REST API for:

• users

• posts

With full CRUD operations.

---

🔥 Conclusion

REST API design is the foundation of backend development.

👉 Simple structure 👉 Predictable routes 👉 Scalable architecture

Once you understand REST principles, building APIs becomes clean, structured, and professional 💪

---

Happy Coding 🚀✨