Skip to main content

POST - Установить статус "Просмотрено"

Описание​

Метод POST /task-executions/seen используется для обновления статуса задач, помечая их как "просмотренные" назначенным исполнителем. Эта операция помогает отслеживать, какие задачи были просмотрены конкретными пользователями.

Авторизация​

Для этого запроса требуется авторизация. Предоставьте действительный токен доступа в заголовке запроса.

Пример заголовка авторизации:​

Authorization: Bearer {your_access_token}

Тело запроса​

Поля:​

  • taskIds (массив строк, обязательное): Идентификаторы задач, которые нужно пометить как "просмотренные".
  • assigneeId (строка, обязательное): Уникальный идентификатор исполнителя, который помечает задачи как "просмотренные".

Пример запроса:​

{
  "taskIds": [
    "1808db4a-aa4f-4431-940e-21ba9662721b",
    "85da85f2-bcb1-459c-8e0e-634d79474457"
  ],
  "assigneeId": "4f9e4741-3069-4a03-8386-5f3ee45791aa"
}

Пример ответа​

Код ответа:​

200 OK

Пример ответа:​

{
  "message": "Задачи успешно помечены как просмотренные",
  "seenTaskIds": [
    "1808db4a-aa4f-4431-940e-21ba9662721b",
    "85da85f2-bcb1-459c-8e0e-634d79474457"
  ]
}

Возможные ошибки​

400 Неверные данные ввода​

Код ответа:​

400 Bad Request

Пример ответа:​

{
  "message": "invalid input data",
  "code": "input.data.invalid",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание:​

Тело запроса содержит неверные данные, такие как отсутствующие обязательные поля или неправильно отформатированные идентификаторы задач.

404 Ресурс не найден​

Код ответа:​

404 Not Found

Пример ответа:​

{
  "message": "resource wasn't found",
  "code": "not.found",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание:​

Один или несколько указанных идентификаторов задач или идентификатор исполнителя не были найдены.

500 Внутренняя ошибка сервера​

Код ответа:​

500 Internal Server Error

Пример ответа:​

{
  "message": "internal server error",
  "code": "internal.server.error",
  "timestamp": "2023-03-07T05:57:59.315Z"
}

Описание:​

Произошла непредвиденная ошибка на сервере. Повторите запрос позже или обратитесь в техническую поддержку.

Итог​

Метод POST /task-executions/seen используется для пометки задач как "просмотренных" конкретным исполнителем. Для доступа к этому методу требуется авторизация. Убедитесь, что в теле запроса содержатся корректные идентификаторы задач и идентификатор исполнителя, чтобы избежать ошибок.