REST API Design Made Simple with Express.js

🚀 Introduction

In modern web development, APIs are everywhere.

👉 They allow different systems (frontend, backend, mobile apps) to communicate with each other

One of the most popular styles of building APIs is:

👉 REST (Representational State Transfer)

Let’s understand REST in the simplest way possible 🔥

---

🧠 What Is a REST API?

A REST API is:

👉 A way for a client (browser/app) to communicate with a server using HTTP

---

💡 Simple Idea

Client → Request → Server → Response

👉 Client asks → Server responds

---

📦 What Are Resources in REST?

In REST, everything is treated as a resource

Examples:

• Users 👤

• Products 📦

• Orders 🧾

👉 Each resource has its own URL

---

Example:

/users
/products

---

⚙️ HTTP Methods (CRUD Operations)

REST uses HTTP methods to perform actions:

Operation	Method	Example
Read	GET	/users
Create	POST	/users
Update	PUT	/users/1
Delete	DELETE	/users/1

👉 This is called CRUD mapping

---

📊 Diagram Idea: CRUD Mapping

GET    → Read  
POST   → Create  
PUT    → Update  
DELETE → Delete  

---

⚙️ Designing Routes (Users Example)

Let’s build a simple REST API for users

---

1️⃣ GET All Users

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

---

2️⃣ GET Single User

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

---

3️⃣ Create User

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

---

4️⃣ Update User

app.put("/users/:id", (req, res) => {
  res.send(`User ${req.params.id} updated`);
});

---

5️⃣ Delete User

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

---

🔢 Status Codes (Basics)

Status codes tell the client what happened:

Code	Meaning
200	OK
201	Created
400	Bad Request
404	Not Found
500	Server Error

---

Example:

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

---

📊 Diagram Idea: Request Lifecycle

Client → Request → Route → Logic → Response

---

🧠 REST Design Principles

👉 Keep URLs clean and meaningful:

❌ Bad:

/getUsers
/createUser

✅ Good:

/users
/users/1

👉 Use HTTP methods instead of action names

---

🧩 Real-World Example

/users           → GET all users  
/users/101       → GET user  
/users           → POST new user  
/users/101       → PUT update  
/users/101       → DELETE  

---

🧠 Conceptual Understanding

👉 REST = Structured way to design APIs 👉 Resources + Methods = Clean API design

---

🏁 Conclusion

REST APIs make your backend:

• Organized

• Scalable

• Easy to understand

---

✨ Final Tip

If your API URLs look like actions → rethink them as resources 😎