Глосарій

REST

REST (Representational State Transfer) — архітектурний стиль для побудови API поверх HTTP. Ресурси адресуються через URL, а дії над ними — через стандартні HTTP-методи. REST не є протоколом чи стандартом — це набір обмежень, які роблять API передбачуваним і масштабованим.

Ключові принципи

Stateless — кожен запит містить усю необхідну інформацію, сервер не зберігає стан між запитами
Єдиний інтерфейс — GET читає, POST створює, PUT/PATCH оновлює, DELETE видаляє
Ресурси — іменники в URL (/users/42), не дієслова (/getUser)
Кешованість — відповіді можуть кешуватись, що знижує навантаження

Коди відповідей

200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 404 Not Found, 422 Unprocessable Entity, 500 Internal Server Error — правильне використання кодів робить API самодокументованим.