Как называется REST-принцип, предполагающий предсказуемое и очевидное поведение методов?

Question

Этот принцип называется Единообразие интерфейса (Uniform Interface). Он означает, что все взаимодействия с сервером должны следовать одним и тем же, предсказуемым правилам. Например, HTTP-методы (GET, POST, PUT, DELETE) имеют строго определенное назначение: GET — для получения данных, DELETE — для удаления. Благодаря этому клиент точно знает, чего ожидать от каждого запроса, а разработчикам проще понимать и использовать API.

YeaHub · Accepted Answer

Принцип Единообразия интерфейса (Uniform Interface) — это один из шести ограничений архитектурного стиля REST, предложенного Роем Филдингом. Его основная цель — упростить и стандартизировать взаимодействие между различными частями системы (клиентами и серверами), сделав его интуитивно понятным и надежным.Что входит в этот принцип?Единообразие интерфейса обычно раскрывается через несколько подпринципов:Идентификация ресурсов: Каждая сущность (пользователь, заказ, статья) должна быть доступна по уникальному идентификатору, обычно в виде URL (например, /users/123).Манипуляция ресурсами через представления: Клиент работает с ресурсом, отправляя или получая его представление в формате JSON, XML и т.д. Сервер может изменить состояние ресурса на основе полученного представления.«Самодостаточные» сообщения: Каждое сообщение (HTTP-запрос или ответ) должно содержать всю необходимую информацию для его обработки. Это включает метод, заголовки и тело.Гипермедиа (HATEOAS): В идеале ответы сервера должны содержать ссылки (гиперссылки) на другие возможные действия с ресурсом или связанные ресурсы, что позволяет клиенту «навигировать» по API динамически. Хотя на практике этот подпринцип часто опускается, он является вершиной единообразия.Почему это важно?Предсказуемость: Разработчик, знающий стандартные HTTP-методы, сразу понимает, что делает DELETE /articles/5, даже видя этот запрос впервые.Независимость: Клиент и сервер могут развиваться независимо, если они придерживаются согласованного контракта (интерфейса).Упрощение: Убирает необходимость придумывать собственные, сложные протоколы для каждого API.Пример нарушения и соблюдения принципаНеправильно (непредсказуемо):textPOST /deleteUser HTTP/1.1
Body: { "id": 123 }Здесь используется метод POST для операции удаления, что не соответствует его стандартному смыслу.Правильно (единообразно и предсказуемо):textDELETE /users/123 HTTP/1.1Метод DELETE четко указывает на намерение, а URL идентифицирует конкретный ресурс.Вывод: Принцип Единообразия интерфейса — краеугольный камень хорошо спроектированного REST API. Его стоит применять всегда при проектировании веб-сервисов, так как он значительно снижает сложность интеграции, улучшает читаемость кода и документации, и делает систему более устойчивой к изменениям.