Отметить диалог прочитанным

Этот метод помечает все сообщения в диалоге прочитанными (со стороны пользователя на сайте). Этот метод используется только на стороне чата для обычного пользователя (не администратора).

На данный момент статус "прочитанности" для администраторов мы не отслеживаем.

URL

POST https://api.carrotquest.io/v1/conversations/{id}/markread

В качестве {id} нужно использовать ID диалога.

Аргументы

Этот метод следует общим правилам. Аргументы передаются как GET или POST параметры.

Аргумент Описание
auth_token Обязательный. Токен авторизации (нужен scope: conversations-write и as-user)

Ответ

{
  "data": {
  }
  "meta": {
    "status": 200
  }
}

Ответ будет пустым.

Ошибки

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

Ошибка Описание
MethodNotAllowed Неверный HTTP-метод
AuthenticationFailed Токен авторизации неверен (или отсутствует)
PermissionDenied Нет доступа к этому диалогу (скорее всего, диалог принадлежит другому приложению)

Примеры

curl -X POST \
  --data-urlencode 'auth_token=XXX' \
  'https://api.carrotquest.io/v1/conversations/7216/markread'