REST - це основний архітектурний принцип Інтернету. Дивовижною справою в Інтернеті є той факт, що клієнти (браузери) та сервери можуть взаємодіяти складними способами, без того, щоб клієнт заздалегідь нічого не знав про сервер та ресурси, які він розміщує. Ключовим обмеженням є те, що і сервер, і клієнт повинні домовитися про використовувані медіа , що у випадку з Інтернетом - це HTML .
API, який дотримується принципів REST , не вимагає від клієнта нічого знати про структуру API. Швидше, сервер повинен надавати будь-яку інформацію, яка потрібна клієнту для взаємодії з сервісом. Приклад цього - форма HTML . Сервер визначає розташування ресурсу та необхідні поля. Браузер не знає заздалегідь, куди подати інформацію, і не знає заздалегідь, яку інформацію надсилати. Обидві форми інформації повністю постачаються сервером. (Цей принцип називається HATEOAS : Hypermedia як двигун стану застосування .)
Отже, як це стосується HTTP та як це можна реалізувати на практиці? HTTP орієнтований на дієслова та ресурси. Два дієслова в головному вживанні є, GETі POST, я думаю, всі визнають. Однак стандарт HTTP визначає кілька інших, таких як PUTі DELETE. Потім ці дієслова застосовуються до ресурсів відповідно до інструкцій, наданих сервером.
Наприклад, давайте уявимо, що у нас є база даних користувачів, якою керує веб-служба. У нашій службі використовується спеціальна гіпермедіа на базі JSON, для якої ми призначаємо міметик application/json+userdb(Можливо, існує application/xml+userdbі application/whatever+userdb- може підтримуватися багато типів медіа). І клієнт, і сервер запрограмовані зрозуміти цей формат, але вони нічого не знають один про одного. Як зазначає Рой Філдінг :
API REST повинен витратити майже всі свої описові зусилля на визначення типів медіа (ів), які використовуються для представлення ресурсів і стану керування додатком, або для визначення розширених імен відносин та / або розмітки з підтримкою гіпертексту для існуючих стандартних типів медіа.
Запит на базовий ресурс /може повернути щось подібне:
Запит
GET /
Accept: application/json+userdb
Відповідь
200 OK
Content-Type: application/json+userdb
{
"version": "1.0",
"links": [
{
"href": "/user",
"rel": "list",
"method": "GET"
},
{
"href": "/user",
"rel": "create",
"method": "POST"
}
]
}
З опису наших ЗМІ ми знаємо, що інформацію про пов'язані ресурси ми можемо знайти з розділів, що називаються «посиланнями». Це називається контролем гіпермедіа . У цьому випадку з такого розділу ми можемо сказати, що ми можемо знайти список користувачів, зробивши ще один запит на /user:
Запит
GET /user
Accept: application/json+userdb
Відповідь
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"
}
]
}
З цієї відповіді ми можемо багато сказати. Наприклад, тепер ми знаємо , що ми можемо створити новий користувач, POSTІНГ /user:
Запит
POST /user
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Karl",
"country": "Austria"
}
Відповідь
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"
}
}
Ми також знаємо, що можемо змінити наявні дані:
Запит
PUT /user/1
Accept: application/json+userdb
Content-Type: application/json+userdb
{
"name": "Emil",
"country": "Bhutan"
}
Відповідь
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"
}
}
Зверніть увагу , що ми використовуємо різні HTTP дієслова ( GET, PUT, POST, і DELETEт.д.) , щоб управляти цими ресурсами, і що тільки знаннями ми припускаємо , з боку клієнта є нашим визначенням ЗМІ.
Подальше читання:
(Ця відповідь була предметом великої критики за те, що я пропустив суть. Здебільшого це була справедлива критика. Те, що я спочатку описав, більше відповідало тому, як REST зазвичай впроваджувався кілька років тому, коли я Спочатку написав це, а не справжнє його значення. Я переглянув відповідь, щоб краще представити реальний сенс.)
