EN VI

RESTful API Là Gì? Đọc Phát Hiểu Luôn

1. RESTful API là gì?

RESTful API là một tiêu chuẩn dùng trong việc thiết kế API cho các ứng dụng web (thiết kế Web services) để tiện cho việc quản lý các resource. Nó chú trọng vào tài nguyên hệ thống (tệp văn bản, ảnh, âm thanh, video, hoặc dữ liệu động…), bao gồm các trạng thái tài nguyên được định dạng và được truyền tải qua HTTP.

2. Các thành phần của RESTful API

API (Application Programming Interface) là một tập các quy tắc và cơ chế mà theo đó, một ứng dụng hay một thành phần sẽ tương tác với một ứng dụng hay thành phần khác. API có thể trả về dữ liệu mà bạn cần cho ứng dụng của mình ở những kiểu dữ liệu phổ biến như JSON hay XML.

REST (REpresentational State Transfer) là một dạng chuyển đổi cấu trúc dữ liệu, một kiểu kiến trúc để viết API. Nó sử dụng phương thức HTTP đơn giản để tạo cho giao tiếp giữa các máy. Vì vậy, thay vì sử dụng một URL cho việc xử lý một số thông tin người dùng, REST gửi một yêu cầu HTTP như GET, POST, DELETE, vv đến một URL để xử lý dữ liệu.

RESTful API là một tiêu chuẩn dùng trong việc thiết kế các API cho các ứng dụng web để quản lý các resource. RESTful là một trong những kiểu thiết kế API được sử dụng phổ biến ngày nay để cho các ứng dụng (web, mobile…) khác nhau giao tiếp với nhau.

Chức năng quan trọng nhất của REST là 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. RESTful không quy định logic code ứng dụng và không giới hạn bởi ngôn ngữ lập trình ứng dụng, bất kỳ ngôn ngữ hoặc framework nào cũng có thể sử dụng để thiết kế một RESTful API.

3. RESTful API hoạt động như thế nào?

Sau khi chúng ta biết được RESTful API là gì thì trong phần này chúng ta cùng tìm hiểu nguyên lý hoạt động của nó nhé. Giống như các giao thức truyền thông hay cấu trúc dữ liệu khác. Để hiểu được bản chất vấn đề thì trước hết cần phải hiểu nguyên lý hoạt động của nó.

REST hoạt động chủ yếu dựa vào giao thức HTTP. Các hoạt động cơ bản nêu trên sẽ sử dụng những phương thức HTTP riêng.

+ GET (SELECT): Trả về một Resource hoặc một danh sách Resource.

+ POST (CREATE): Tạo mới một Resource.

+ PUT (UPDATE): Cập nhật thông tin cho Resource.

+ DELETE (DELETE): Xoá một Resource.

Những phương thức hay hoạt động này thường được gọi là CRUD tương ứng với Create, Read, Update, Delete – Tạo, Đọc, Sửa, Xóa.

Hiện tại đa số lập trình viên viết RESTful API giờ đây đều chọn JSON là format chính thức nhưng cũng có nhiều người chọn XML làm format, nói chung dùng thế nào cũng được miễn tiện và nhanh.

4. Authentication request và cấu trúc dữ liệu trả về

RESTful API không sử dụng session và cookie, nó sử dụng một access_token với mỗi request. Bạn có thể tìm hiểu JWT (JsonWebToken) để biết rõ hơn. Dữ liệu trả về thường có cấu trúc như sau:

{
    "status_code": 200,
    "data": [{
            "name": "Nguyen Van A",
            "email": "[email protected]",
            "hoby": ""
        },
        {
            "name": "Nguyen Van B",
            "email": "[email protected]",
            "hoby": "eat"
        }
    ],
    error_messages: ""
}

5. Status code

Khi chúng ta request một API nào đó thường thì sẽ có vài status code để nhận biết sau:

+ 200 OK – Trả về thành công cho những phương thức GET, PUT, PATCH hoặc DELETE.

+ 201 Created – Trả về khi một Resouce vừa được tạo thành công.

+ 204 No Content – Trả về khi Resource xoá thành công.

+ 304 Not Modified – Client có thể sử dụng dữ liệu cache.

+ 400 Bad Request – Request không hợp lệ

+ 401 Unauthorized – Request cần có auth.

+ 403 Forbidden – bị từ chối không cho phép.

+ 404 Not Found – Không tìm thấy resource từ URI

+ 405 Method Not Allowed – Phương thức không cho phép với user hiện tại.

+ 410 Gone – Resource không còn tồn tại, Version cũ đã không còn hỗ trợ.

+ 415 Unsupported Media Type – Không hỗ trợ kiểu Resource này.

+ 422 Unprocessable Entity – Dữ liệu không được xác thực

+ 429 Too Many Requests – Request bị từ chối do bị giới hạn

Trong Ruby on Rails có thể sử dụng symbol status code hoặc 3 chữ số integer

6. Quản lí version của API

Khi thiết API cho APP IOS hay client side, chúng ta nên đặt version cho các api. Ví dụ như endpoint sau: api/v1/users Điều này sẽ giúp hệ thống sau khi nâng cấp lên version mới vẫn hộ trợ các api của version cũ, cũng như giúp việc bảo trì, sửa chữa dễ dàng hơn.

7. Ưu điểm của RESTFUL API là gì?

Như trình bày ở trên, việc sử dụng RESTFUL API mang lại những hiệu quả nhất định cho các lập trình viên. Vậy những lợi ích nó mang lại là gì ? So với các phương pháp khác nó sẽ có điểm gì vượt trội.

Một số ưu điểm chính khi sử dụng RESTFUL API là:

+ Giúp cho ứng dụng rõ ràng hơn

+ REST URL đại diện cho resource chứ không phải hành động

+ Dữ liệu được trả về với nhiều định dạng khác nhau như: xml, html, json….

+ Code đơn giản và ngắn gọn

+ REST chú trọng vào tài nguyên của hệ thống

Những trang web ngày nay thường sử dụng REST API để cho phép kết nối đến dữ liệu của họ. Trong đó, facebook cũng cung cấp các REST API để giúp các ứng dụng bên ngoài kết nối đến dữ liệu của họ

Rating: 10 (1 Votes)