SDN302 Chương 6 - Xây dựng REST API với Express, MongoDB và Mongoose

PUT và PATCH là hai phương thức thường được sử dụng trong REST APIs để cập nhật dữ liệu. PUT được sử dụng để cập nhật toàn bộ tài nguyên, trong khi PATCH được sử dụng để cập nhật một phần của tài nguyên. Ví dụ, nếu bạn muốn cập nhật thông tin của một người dùng, bạn có thể sử dụng PUT để cập nhật toàn bộ thông tin của người dùng, bao gồm cả thông tin không được thay đổi. Ngược lại, nếu bạn chỉ muốn cập nhật một phần của thông tin người dùng, chẳng hạn như cập nhật địa chỉ email, bạn có thể sử dụng PATCH để chỉ cập nhật phần đó. Điều này giúp giảm thiểu số lượng dữ liệu được gửi và nhận, cũng như giảm thiểu thời gian xử lý.

Trong RESTful API, phương thức HTTP được sử dụng để tạo một tài nguyên mới thường là POST. Phương thức POST được sử dụng để gửi dữ liệu đến một URL để tạo một tài nguyên mới. Ví dụ, khi bạn muốn tạo một tài khoản mới trên một trang web, bạn sẽ gửi một yêu cầu POST đến URL tạo tài khoản với các thông tin về tài khoản mới. Phương thức POST khác với phương thức GET, vì GET chỉ được sử dụng để đọc dữ liệu từ một URL, trong khi POST được sử dụng để tạo hoặc cập nhật dữ liệu. Ngoài ra, phương thức POST cũng khác với phương thức PUT, vì PUT được sử dụng để cập nhật một tài nguyên hiện có, trong khi POST được sử dụng để tạo một tài nguyên mới. Cuối cùng, phương thức DELETE được sử dụng để xóa một tài nguyên hiện có, không phải tạo một tài nguyên mới.

Để bảo mật một API RESTful, có nhiều phương pháp được sử dụng. Trước hết, việc sử dụng HTTPS cho tất cả các giao tiếp là một biện pháp quan trọng. Điều này giúp mã hóa dữ liệu được truyền qua internet, ngăn chặn việc nghe trộm và thay đổi dữ liệu. Ngoài ra, việc sử dụng JWT (JSON Web Tokens) cho xác thực cũng là một cách hiệu quả. JWT cho phép xác thực người dùng một cách an toàn và bảo mật, giảm thiểu rủi ro giả mạo tài khoản. Tuy nhiên, việc bao gồm API keys trong tham số URL không phải là một phương pháp bảo mật, vì nó có thể dễ bị lộ và bị đánh cắp. Việc vô hiệu hóa CORS (Cross-Origin Resource Sharing) cũng không phải là một biện pháp bảo mật, vì nó có thể gây ra các vấn đề về tương tác giữa các trang web khác nhau.

Để lấy dữ liệu từ một API REST, bạn cần sử dụng phương thức HTTP phù hợp. Trong các phương thức HTTP phổ biến như POST, GET, DELETE, PUT, thì phương thức GET là lựa chọn tốt nhất. Phương thức GET được sử dụng để yêu cầu dữ liệu từ một nguồn nào đó, thường được sử dụng để đọc dữ liệu mà không cần thay đổi nó. Ví dụ, khi bạn truy cập một trang web bằng đường dẫn URL, trình duyệt của bạn sẽ gửi một yêu cầu GET đến máy chủ để lấy dữ liệu trang web đó. Trong REST API, phương thức GET cũng được sử dụng tương tự, để lấy dữ liệu từ một nguồn nào đó. Vì vậy, phương thức GET là lựa chọn phù hợp để lấy dữ liệu từ một API REST.

Để kiểm tra các API RESTful, chúng ta thường sử dụng các công cụ hỗ trợ. Trong số các lựa chọn trên, công cụ được sử dụng phổ biến nhất là Postman. Postman là một ứng dụng web và ứng dụng di động cho phép người dùng gửi yêu cầu HTTP và xem phản hồi từ các API. Nó cung cấp một giao diện người dùng thân thiện và dễ sử dụng, giúp người dùng dễ dàng tạo và gửi các yêu cầu HTTP, chẳng hạn như GET, POST, PUT và DELETE. Ngoài ra, Postman cũng cho phép người dùng lưu trữ và quản lý các yêu cầu HTTP, cũng như tạo và quản lý các môi trường thử nghiệm.

REST là một kiến trúc ứng dụng được thiết kế để cung cấp các dịch vụ trên internet. Nó dựa trên các nguyên tắc như client-server, stateless, cacheable, và uniform interface. RESTful routing trong Express.js được hỗ trợ thông qua các phương thức như app.get, app.post, app.put, và app.delete. Điều này cho phép chúng ta tạo ra các route RESTful để xử lý các yêu cầu HTTP khác nhau. Ví dụ, chúng ta có thể tạo một route để xử lý yêu cầu GET để lấy dữ liệu, hoặc một route để xử lý yêu cầu POST để tạo mới dữ liệu.

RESTful APIs (Application Programming Interfaces) là một phương thức giao tiếp giữa các ứng dụng hoặc hệ thống. Lợi ích chính của việc sử dụng RESTful APIs là sự nhất quán và khả năng mở rộng. Điều này có nghĩa là các ứng dụng hoặc hệ thống có thể giao tiếp với nhau một cách dễ dàng và hiệu quả, bất kể họ được xây dựng trên nền tảng nào. Sự nhất quán và khả năng mở rộng của RESTful APIs cho phép các ứng dụng hoặc hệ thống được thiết kế để hoạt động cùng nhau một cách trơn tru, giảm thiểu thời gian và công sức cần thiết để tích hợp và duy trì chúng. Điều này đặc biệt quan trọng trong các hệ thống lớn và phức tạp, nơi sự nhất quán và khả năng mở rộng là cần thiết để đảm bảo hiệu suất và độ tin cậy.

Khi thực hiện một yêu cầu GET đến đường dẫn /users trong ứng dụng Express.js, ứng dụng sẽ trả về một phản hồi JSON. Trong đoạn mã được cung cấp, hàm get được sử dụng để định nghĩa hành vi khi nhận được yêu cầu GET đến đường dẫn /users. Hàm này sử dụng phương thức status để thiết lập trạng thái phản hồi thành 200, biểu thị cho trạng thái thành công. Sau đó, hàm json được sử dụng để trả về một đối tượng JSON có chứa thông điệp "List of users". Điều này cho thấy ứng dụng sẽ trả về một phản hồi JSON có chứa thông điệp này khi nhận được yêu cầu GET đến đường dẫn /users.

Trong mô hình RESTful API, phương thức DELETE thường được sử dụng để xóa một tài nguyên khỏi hệ thống. Khi một yêu cầu DELETE được gửi đến một URL cụ thể, API sẽ tìm kiếm và loại bỏ tài nguyên đó khỏi cơ sở dữ liệu. Điều này giúp giảm thiểu số lượng dữ liệu không cần thiết và cải thiện hiệu suất của hệ thống. Ví dụ, nếu bạn muốn xóa một bài viết khỏi một trang web blog, bạn sẽ gửi một yêu cầu DELETE đến URL của bài viết đó. Sau đó, API sẽ tìm kiếm và xóa bài viết khỏi cơ sở dữ liệu, đồng thời cập nhật trạng thái của bài viết thành 'đã xóa'.

Trong RESTful API, để tạo và thay thế hoàn toàn một tài nguyên, chúng ta nên sử dụng hai phương thức HTTP khác nhau. Phương thức POST thường được sử dụng để tạo một tài nguyên mới, trong khi phương thức PUT được sử dụng để thay thế hoàn toàn một tài nguyên hiện có. Ví dụ, khi chúng ta muốn tạo một tài khoản mới, chúng ta sẽ gửi một yêu cầu POST đến API, trong khi khi muốn cập nhật thông tin của tài khoản hiện có, chúng ta sẽ gửi một yêu cầu PUT đến API. Điều này giúp phân biệt rõ ràng giữa việc tạo và thay thế tài nguyên, từ đó giúp API trở nên dễ sử dụng và dễ hiểu hơn.

Trong RESTful APIs, định dạng dữ liệu trao đổi được khuyến nghị là JSON. JSON (JavaScript Object Notation) là một định dạng dữ liệu nhẹ, dễ đọc và dễ hiểu. Nó được sử dụng rộng rãi trong các ứng dụng web và API để trao đổi dữ liệu giữa máy chủ và khách hàng. JSON cho phép lưu trữ và truyền tải dữ liệu dưới dạng các đối tượng JSON, bao gồm các thuộc tính và giá trị. Điều này làm cho nó trở thành một lựa chọn phổ biến cho các ứng dụng cần trao đổi dữ liệu nhanh chóng và hiệu quả. Ví dụ, khi một ứng dụng yêu cầu dữ liệu từ một API, API sẽ trả về dữ liệu dưới dạng JSON, và ứng dụng sẽ xử lý dữ liệu đó. JSON cũng hỗ trợ các tính năng như dữ liệu có thể được đọc và viết dễ dàng, dữ liệu có thể được kiểm tra và xác minh, và dữ liệu có thể được bảo mật bằng cách sử dụng các phương thức mã hóa.

Trong REST, các phương thức HTTP được sử dụng để thực hiện các hành động khác nhau trên tài nguyên. Các phương thức phổ biến bao gồm GET, POST, DELETE. Tuy nhiên, phương thức FETCH không phải là một phương thức HTTP hợp lệ trong REST. FETCH là một phương thức được sử dụng trong JavaScript để thực hiện các yêu cầu HTTP, nhưng nó không phải là một phần của tiêu chuẩn HTTP. Vì vậy, trong danh sách phương thức HTTP hợp lệ trong REST, chúng ta không bao gồm FETCH.