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:
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.
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:
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.
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.
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:
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:
Kết quả mong đợi:
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.
Sau đó thêm một dev script vào package.json:
Bây giờ chạy server ở chế độ phát triển:
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:
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.