helpdesk.ticket.getMy

Scope: helpdesk

Кто может вызывать: Авторизованный; фильтр: автор, ответственный или наблюдатель = текущий пользователь.

Список «моих» обращений

HTTP: GET

Побочные эффекты: none

Параметры метода

Параметр Тип Обяз. Описание
limit, offset, fetchAll, filter — нет Как в ticket.list; доп. OR-фильтр по роли пользователя накладывается на сервере

Поля filter (Mongo)

Дополнительно к серверному фильтру «мои» можно передать id, title, statusId, criticalityId, priority (≡ criticalityId), categoryId, responsibleId, ownerId, createdAt, closedAt, timestampX, lastMessageDate, lamp, isOverdue, slaId, markId, siteId, sourceId, modifiedBy, messagesCount.

Возвращаемые данные

  • result.result — массив обращений
  • total / next — верхний уровень; next только если есть следующая страница (overview)

Обработка ошибок

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
UNAUTHORIZED Пользователь не авторизован
INVALID_LIMIT limit < 1
LIMIT_TOO_LARGE limit > 500
INVALID_OFFSET offset < 0
INVALID_FILTER Некорректный filter или неизвестное поле
INVALID_FILTER_OPERATOR Неизвестный оператор фильтра
FETCHALL_LIMIT_EXCEEDED При fetchAll=true подходящих записей больше защитного лимита (5000)
INTERNAL Внутренняя ошибка сервера

Пример запроса (GET)

curl -G "https://76575.dev.wehive.digital/rest/1/lus1tijk9ll7mg7h/helpdesk.ticket.getMy.json" -H "Accept: application/json" --data-urlencode "limit=20"

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

{
          "result": {
            "result": [
              {
                "id": 2,
                "title": "Postman test ticket",
                "ownerId": 1,
                "responsibleId": 0,
                "isClosed": false
              }
            ],
            "error": null
          },
          "total": 1
        }

См. также

Предыдущая
helpdesk.ticket.search
Следующая
helpdesk.ticket.getOverdue