Trong thời đại web hiện đại, việc tách biệt frontend và backend là xu hướng phổ biến. REST API đóng vai trò cầu nối để frontend và backend giao tiếp hiệu quả. Bài viết này sẽ hướng dẫn bạn cách xây dựng một REST API cơ bản sử dụng Node.js và Express.js, nền tảng phổ biến, dễ học và mạnh mẽ.
Yêu cầu trước khi bắt đầu
- Đã cài đặt Node.js (https://nodejs.org/)
- Biết căn bản về JavaScript
- Có trình quản lý gói npm (tự đi kèm với Node.js)
1. Tạo dự án Node.js
Mở terminal và thực hiện:
mkdir rest-api-demo
cd rest-api-demo
npm init -y
Thư mục sẽ tạo ra file package.json.
2. Cài đặt Express.js
npm install express
3. Tạo file chính index.js
const express = require(‘express’);
const app = express();
const port = 3000;
// Middleware để xử lý JSON
app.use(express.json());
// Sample dữ liệu
let users = [
{ id: 1, name: “Nguyễn Văn A” },
{ id: 2, name: “Trần Thị B” }
];
// Routes
app.get(‘/’, (req, res) => {
res.send(‘Welcome to REST API with Express!’);
});
// Lấy tất cả users
app.get(‘/users’, (req, res) => {
res.json(users);
});
// Lấy 1 user theo ID
app.get(‘/users/:id’, (req, res) => {
const user = users.find(u => u.id == req.params.id);
if (!user) return res.status(404).json({ error: ‘User not found’ });
res.json(user);
});
// Thêm user mới
app.post(‘/users’, (req, res) => {
const newUser = {
id: users.length + 1,
name: req.body.name
};
users.push(newUser);
res.status(201).json(newUser);
});
// Cập nhật user
app.put(‘/users/:id’, (req, res) => {
const user = users.find(u => u.id == req.params.id);
if (!user) return res.status(404).json({ error: ‘User not found’ });
user.name = req.body.name;
res.json(user);
});
// Xóa user
app.delete(‘/users/:id’, (req, res) => {
users = users.filter(u => u.id != req.params.id);
res.json({ message: ‘User deleted’ });
});
// Khởi động server
app.listen(port, () => {
console.log(`REST API listening at http://localhost:${port}`)
});
4. Chạy thử ứng dụng
node index.js
Truy cập thử http://localhost:3000/users bằng Postman hoặc trình duyệt để xem dữ liệu.
6. Thử nghiệm RESTful API bằng Postman
Có thể dùng Postman hoặc curl để kiểm thử các thao tác:
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
| GET | /users | Lấy danh sách người dùng |
| GET | /users/:id | Lấy chi tiết người dùng |
| POST | /users | Thêm người dùng mới |
| PUT | /users/:id | Cập nhật người dùng |
| DELETE | /users/:id | Xóa người dùng |
Bạn vừa hoàn thành một REST API đơn giản sử dụng Express.js. Đây là nền tảng quan trọng cho việc xây dựng các ứng dụng web hiện đại. Ở các bài tiếp theo, bạn có thể tìm hiểu thêm:
- Kết nối với cơ sở dữ liệu (MongoDB, PostgreSQL…)
- Sử dụng middleware nâng cao (CORS, Logger…)
- Authentication (JWT)
- Deploy lên môi trường thực tế (Heroku, Vercel, VPS…)
Giảng viên Trần Thị Mỹ Lệ
Bộ môn Công nghệ thông tin
FPT Polytechnic TP HCM
