REST là nguyên tắc kiến trúc cơ bản của web. Điều tuyệt vời về web là thực tế rằng máy khách (trình duyệt) và máy chủ có thể tương tác theo những cách phức tạp mà không cần khách hàng biết trước về máy chủ và tài nguyên mà nó lưu trữ. Hạn chế chính là cả máy chủ và máy khách đều phải đồng ý về phương tiện được sử dụng, trong trường hợp web là HTML .
Một API tuân thủ các nguyên tắc của REST không yêu cầu khách hàng biết bất cứ điều gì về cấu trúc của API. Thay vào đó, máy chủ cần cung cấp bất kỳ thông tin nào khách hàng cần để tương tác với dịch vụ. Biểu mẫu HTML là một ví dụ về điều này: Máy chủ chỉ định vị trí của tài nguyên và các trường bắt buộc. Trình duyệt không biết trước nơi gửi thông tin và không biết trước thông tin nào cần gửi. Cả hai dạng thông tin đều được cung cấp hoàn toàn bởi máy chủ. (Nguyên tắc này được gọi là HATEOAS : Hypermedia là động cơ của trạng thái ứng dụng .)
Vì vậy, làm thế nào điều này áp dụng cho HTTP và làm thế nào nó có thể được thực hiện trong thực tế? HTTP được định hướng xung quanh các động từ và tài nguyên. Hai động từ trong cách sử dụng chính là GETvà POST, mà tôi nghĩ mọi người sẽ nhận ra. Tuy nhiên, tiêu chuẩn HTTP định nghĩa một số khác như PUTvà DELETE. Những động từ này sau đó được áp dụng cho các tài nguyên, theo các hướng dẫn được cung cấp bởi máy chủ.
Ví dụ: Hãy tưởng tượng rằng chúng ta có cơ sở dữ liệu người dùng được quản lý bởi một dịch vụ web. Dịch vụ của chúng tôi sử dụng một hypermedia tùy chỉnh dựa trên JSON, mà chúng tôi chỉ định mô phỏng application/json+userdb(Cũng có thể có application/xml+userdbvà application/whatever+userdb- nhiều loại phương tiện có thể được hỗ trợ). Cả máy khách và máy chủ đều được lập trình để hiểu định dạng này, nhưng chúng không biết gì về nhau. Như Roy Fielding chỉ ra:
API REST nên dành hầu hết tất cả nỗ lực mô tả của nó để xác định (các) loại phương tiện được sử dụng để thể hiện tài nguyên và trạng thái ứng dụng lái xe hoặc trong việc xác định tên quan hệ mở rộng và / hoặc đánh dấu siêu văn bản cho các loại phương tiện tiêu chuẩn hiện có.
Một yêu cầu cho tài nguyên cơ sở /có thể trả về một cái gì đó như thế này:
Yêu cầu
GET /
Accept: application/json+userdb
Phản ứng
200 OK
Content-Type: application/json+userdb
{
"version": "1.0",
"links": [
{
"href": "/user",
"rel": "list",
"method": "GET"
},
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
Chúng tôi biết từ mô tả về phương tiện truyền thông của mình rằng chúng tôi có thể tìm thấy thông tin về các tài nguyên liên quan từ các phần được gọi là "liên kết". Điều này được gọi là điều khiển Hypermedia . Trong trường hợp này, chúng tôi có thể nói từ một phần như vậy mà chúng tôi có thể tìm thấy danh sách người dùng bằng cách thực hiện một yêu cầu khác cho /user:
Yêu cầu
GET /user
Accept: application/json+userdb
Phản ứng
200 OK
Content-Type: application/json+userdb
{
"users": [
{
"id": 1,
"name": "Emil",
"country: "Sweden",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
{
"id": 2,
"name": "Adam",
"country: "Scotland",
"links": [
{
"href": "/user/2",
"rel": "self",
"method": "GET"
},
{
"href": "/user/2",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/2",
"rel": "delete",
"method": "DELETE"
}
]
}
],
"links": [
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
Chúng tôi có thể nói rất nhiều từ phản ứng này. Ví dụ, bây giờ chúng ta biết chúng ta có thể tạo một người dùng mới bằng cách POSTing để /user:
Yêu cầu
POST /user
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Karl",
"country": "Austria"
}
Phản ứng
201 Created
Content-Type: application/json+userdb
{
"user": {
"id": 3,
"name": "Karl",
"country": "Austria",
"links": [
{
"href": "/user/3",
"rel": "self",
"method": "GET"
},
{
"href": "/user/3",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/3",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
Chúng tôi cũng biết rằng chúng tôi có thể thay đổi dữ liệu hiện có:
Yêu cầu
PUT /user/1
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Emil",
"country": "Bhutan"
}
Phản ứng
200 OK
Content-Type: application/json+userdb
{
"user": {
"id": 1,
"name": "Emil",
"country": "Bhutan",
"links": [
{
"href": "/user/1",
"rel": "self",
"method": "GET"
},
{
"href": "/user/1",
"rel": "edit",
"method": "PUT"
},
{
"href": "/user/1",
"rel": "delete",
"method": "DELETE"
}
]
},
"links": {
"href": "/user",
"rel": "list",
"method": "GET"
}
}
Chú ý rằng chúng ta đang sử dụng động từ HTTP khác nhau ( GET, PUT, POST, DELETEvv) để thao tác các tài nguyên, và rằng những kiến thức duy nhất chúng ta đoán trên một phần của khách hàng là định nghĩa phương tiện truyền thông của chúng tôi.
Đọc thêm:
. lần đầu tiên viết điều này, thay vì ý nghĩa thực sự của nó. Tôi đã sửa đổi câu trả lời để thể hiện tốt hơn ý nghĩa thực sự.)
