Означает ли это нарушение безгражданства API RESTful?

Question

Возьмите эту конструкцию из API:

• /articles/{id} - возвращает статью. Клиент предоставляет маркер в заголовке для их идентификации.
• /updated-articles - Возвращает коллекцию статей, обновленных со времени последнего вызова клиента до этой конечной точки, и включает только статьи, которые ранее запрашивал этот клиент. Клиент предоставляет маркер в заголовке для их идентификации.

Вторая точка привязки не очень хорошо подходит для меня. Мотивацией дизайна этой второй точки является то, что клиенту не нужно отслеживать время их последних запросов. Разве это нарушает ограничение «безгражданства» API RESTful? Альтернативным подходом будет /updated-articles?since=YYYY-MM-DD, но для этого потребуется, чтобы клиенты помнили

Answer 1

Ваш «токен» - это, в основном, идентификатор клиента, а факт запоминания даты последнего доступа - это сохранение состояния клиента на сервере.

Подумайте об этом: если вам нужно было увеличить свою услугу, вы могли бы просто подключить новый сервер, скопировать файлы своей службы и перенаправить с помощью циклического алгоритма на том или ином из двух серверов (без с которыми они обмениваются информацией)? Очевидно, нет, потому что вам понадобится ваша таблица tokens<->date of last consultation, разделяемая между двумя серверами. Так что нет, это определенно не без гражданства.

Кроме того, я не понимаю вашу точку:

Альтернативный подход будет/обновляемые-статьи, так как = YYYY-MM-DD , но это потребует клиентов помнить

?

Не будет ли токен требовать, чтобы клиент помнил? Напротив, таким способом будет RESTful, поскольку клиентское состояние (дата последней консультации) будет храниться на стороне клиента.

Answer 2

В принципе, нет, я не думаю, что ваш второй ресурс нарушит безгражданство.

Я думаю, что это нормально, если ваш клиент отслеживает их собственную «обновленную» отметку времени. Ваш апи должен быть без гражданства. Клиент не должен быть без гражданства.

В любом случае клиент должен сохранять много состояния. Клиент будет устройством, центральным для одного пользователя и его конкретными потребностями. Он отвечает за отслеживание потребностей пользователя и текущего состояния. В этой ситуации кому-то придется хранить эту метку времени. Я думаю, что это должны быть ваши клиенты, а не ваш сервер.

Это только мое мнение.

Я нашел запись по истинному значению безгражданства, которое, как я думаю, также может принести вам пользу here.

Answer 3

Нам следует избегать создания конечных точек без связанного объекта.Так что вместо того, чтобы /updated-articles?since=<timestamp> лучший подход должен быть:

• /articles?updated=true&since-last-request=true или
• /articles?updated-since-last-request=true

Если предполагаемый результат должен влиять на всех клиентов. Значение каждой отметки времени запроса должно храниться на сервере. Или

• /articles?updated-since=<timestamp>

Если предполагаемый результат зависит от каждого поведения клиента. Кажется, это ваш случай.

Выбор между прежним или последним (или обоими) зависит от варианта использования. Но главное - избегать, создавая конечные точки без связанной сущности и имеющие специальные случаи, определяемые параметрами.

В качестве ориентира:

Конечных точек являются существительными, прилагательных являются параметрами и глаголов являются методами запроса HTTP

Это также означает просто ' GET/articles 'означает возвращение ВСЕ статей. Чтобы избежать злоупотреблений, вы можете выдать правильные коды 4xx в зависимости от случая.