Должен ли флаг представления обновляться API или потребителем?

Question

Я действительно надеюсь, что этот вопрос слишком субъективен, поскольку я на самом деле ищу "лучшую практику", которая имеет смысл. Однако вопрос немного шире, чем просто этот случай.

Допустим, у меня есть флаг вида на объект (виден или нет). Когда этот объект виден, я вижу три варианта, чтобы сделать его истинным:

1. Пусть потребитель приложения установит его, выдав UPDATE вызов
2. Когда мы называем GetObject метод, мы автоматически устанавливаем "увиденное" в true
3. Мы добавляем метод в API, говоря SetToSeen которую потребитель должен установить

Какой здесь выгодный подход?

Answer 1

Для меня это зависит от того, кто использует этот флаг.

Если это клиент, то клиент должен обновить объект (возможно, "увиденный" может читаться как "отображаемый пользователю"), как PUT /object/{id}/seen,

Если это только для сервера и читается как "отображается клиенту", то сервер должен обновить, если объект был обслужен.