Hoàn thành bài "Bài 1: Nền tảng REST và HTTP" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Trước khi có thể xây dựng một REST API, bạn cần có nền tảng dự án hoạt động được. Bài học này sẽ hướng dẫn từng bước: khởi tạo dự án Node.js, cài đặt Express, viết một server tối giản và xác nhận nó thực sự chạy được. Đến cuối bài, bạn sẽ có một server đang chạy có khả năng phản hồi các HTTP request — nền tảng mà mọi bài học tiếp theo sẽ xây dựng trên đó.

Bài học giả định rằng Node.js (phiên bản 18 trở lên) và npm đã được cài đặt trên máy của bạn. Hãy chạy hai lệnh sau để kiểm tra trước khi tiếp tục:

bash
node --version
npm --version

Nếu một trong hai lệnh trả về lỗi, hãy tải Node.js từ nodejs.org (npm được đi kèm theo).

Khởi tạo dự án

Tạo một thư mục mới cho dự án của bạn và khởi tạo nó như một package Node.js. Lệnh init sẽ tạo ra file package.json, file này lưu trữ metadata và các dependency của dự án.

bash
mkdir my-rest-api
cd my-rest-api
npm init -y

Cờ -y chấp nhận tất cả giá trị mặc định nên bạn sẽ không bị hỏi tên dự án, phiên bản, v.v. Bạn có thể chỉnh sửa package.json thủ công bất cứ lúc nào. Ở thời điểm này, thư mục của bạn chỉ chứa duy nhất một file đó — chưa có code nào.

Tiếp theo, cài đặt Express:

bash
npm install express

Lệnh này sẽ tải Express và các dependency của nó vào thư mục node_modules, đồng thời ghi lại dependency trong package.json dưới mục "dependencies". Bạn cũng sẽ thấy một file package-lock.json được tạo ra — file này khóa chính xác phiên bản của các dependency để mọi thành viên trong nhóm đều cài đặt các package giống hệt nhau.

sơ đồ luồng gồm 3 bước: npm init tạo file package.json, npm install express thêm Express vào node_modules và cập nhật dependencies trong package.json, sau đó server.js import Express để tạo ứng dụng

Xây dựng Server đầu tiên

Tạo một file tên server.js ở thư mục gốc của dự án. File này là điểm vào (entry point) của ứng dụng.

javascript
const express = require('express');
const app = express();
const PORT = 3000;
app.get('/', (req, res) => {
res.json({ message: 'Server is running' });
});
app.listen(PORT, () => {
console.log(`Server listening on http://localhost:${PORT}`);
});

Giải thích từng phần: require('express') import framework. Gọi express() tạo một application instance được lưu vào biến app. app.get() đăng ký một route handler — đối số thứ nhất là đường dẫn URL, đối số thứ hai là callback nhận vào đối tượng request (req) và đối tượng response (res). res.json() gửi phản hồi JSON và tự động thiết lập header Content-Type. Cuối cùng, app.listen() gắn server vào một port và bắt đầu nhận kết nối.

Khởi động server:

bash
node server.js

Bạn sẽ thấy thông báo trên console. Mở trình duyệt tại http://localhost:3000 hoặc dùng curl:

bash
curl http://localhost:3000

Kết quả mong đợi:

json
{"message": "Server is running"}

Cải thiện quy trình phát triển

Việc khởi động lại server thủ công sau mỗi lần thay đổi code rất mệt mỏi. Hãy cài nodemon như một development dependency — nó theo dõi các file của bạn và tự động khởi động lại khi phát hiện thay đổi.

bash
npm install --save-dev nodemon

Sau đó thêm một dev script vào package.json:

json
{
"scripts": {
"start": "node server.js",
"dev": "nodemon server.js"
}
}

Bây giờ chạy server ở chế độ phát triển:

bash
npm run dev

Chỉnh sửa server.js, lưu lại, và nodemon sẽ tự khởi động lại tiến trình mà bạn không cần làm gì thêm. Script start vẫn được giữ lại để dùng cho môi trường production — nơi nodemon không phù hợp.

Một cải tiến nữa: phân tích (parse) body của request dạng JSON. Express mặc định không làm điều này. Thêm dòng middleware này trước các route của bạn:

javascript
app.use(express.json());

Nếu không có dòng này, req.body sẽ là undefined khi client gửi request POST kèm payload JSON. Việc thêm nó ngay bây giờ sẽ giúp bạn tránh những rắc rối mất thời gian khi debug sau này.

Tóm tắt

Bây giờ bạn đã có một dự án Express hoàn chỉnh: một package.json theo dõi các dependency, Express đã được cài đặt, một server.js lắng nghe trên cổng 3000, một route GET hoạt động, nodemon để lặp nhanh, và đã bật tính năng parse body JSON. Đây chính là bộ khung dùng làm điểm khởi đầu cho mọi pattern REST API được đề cập trong phần còn lại của khóa học. Bài học tiếp theo sẽ đi vào routing — định nghĩa nhiều endpoint và tổ chức chúng một cách gọn gàng khi API phình to.