RESTful API

Ghi chép về RESTful API

RESTful


1. Việc quản lý resource (tài nguyên) của một website bao gồm 4 tác vụ chính:

+ Tạo mới một resource (create)
+ Lấy thông tin một resource (read)
+ Cập nhật một resource (update)
+ Xoá một resource (delete)

2. RESTful API là một tiêu chuẩn dùng trong việc thết kế các thiết kế API cho các ứng dụng web để quản lý các resource

3. REST quy định cách sử dụng các HTTP method (như GET, POST, PUT, DELETE...) và cách định dạng các URL cho ứng dụng web để quản các resource.

Ví dụ với một trang blog để quản lý các bài viết chúng ta có các URL đi với HTTP method như sau:
+ URL tạo bài viết: http://my-blog.xyz/posts. Tương ứng với HTTP method là POST
+ URL đọc bài viết với ID là 123: http://my-blog.xyz/posts/123. Tương ứng với HTTP method là GET
+ URL cập nhật bài viết với ID là 123: http://my-blog.xyz/posts/123. Tương ứng với HTTP method là PUT
+ URL xoá bài viết với ID là 123: http://my-blog.xyz/posts/123. Tương ứng với HTTP method là DELETE

4. Với các ứng dụng web được thiết kế sử dụng RESTful, lập trình viên có thể dễ dàng biết được URL và HTTP method để quản lý một resource

5. REST là viết tắt của cụm từ Representational State Transfer và các ứng dụng sử dụng kiểu thiết kế REST thì được gọi là RESTful (-ful là tiếp vị ngữ giống như beauty và beautiful)