Ключевые принципы
- 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 самодокументируемым.