Перейти к содержанию

Получение метрики времени задачи

Возвращает данные одной метрики времени задачи.

GET /cwm/public/api/v1/workspaces/{workspace}/workitems/{workitem}/workitem-time-metrics/{metricId}

Параметры и описание запроса

workspace (обязательный)

Ключ или идентификатор пространства

workitem (обязательный)

Ключ или идентификатор задачи

metricId (обязательный)

Идентификатор метрики времени (guid)

Тело успешного ответа 200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workitemId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "templateId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "type": "Sla",
  "limitSeconds": 14400,
  "approachThresholdPercent": 80,
  "workCalendarId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "InProgress",
  "elapsedSeconds": 3600,
  "isTicking": true,
  "approachAt": "2026-01-16T10:00:00Z",
  "breachAt": "2026-01-16T12:00:00Z"
}

Описание возвращаемой модели

id

Идентификатор метрики времени

workitemId

Идентификатор задачи

templateId

Идентификатор шаблона метрики времени

name

Название метрики

type

Тип метрики: Sla, Ola или Custom

limitSeconds

Лимит времени в секундах

approachThresholdPercent

Порог приближения к лимиту в процентах

workCalendarId

Идентификатор рабочего календаря, по которому идёт отсчёт

status

Статус метрики. Возможные значения:

  • NotStarted — метрика подключена, отсчёт не запускался;
  • InProgress — отсчёт идёт;
  • Approaching — достигнут порог приближения к лимиту;
  • Paused — отсчёт приостановлен;
  • Breached — лимит превышен, отсчёт продолжается;
  • CompletedInTime — метрика завершена без превышения лимита;
  • CompletedBreached — метрика завершена с превышением лимита;
  • Disabled — метрика отключена.

elapsedSeconds

Затраченное рабочее время в секундах

isTicking

Признак того, что отсчёт времени идёт в данный момент

approachAt

Расчётные дата и время достижения порога приближения к лимиту

breachAt

Расчётные дата и время превышения лимита

Ошибки запроса

400 Bad Request

Неправильный (несуществующий) параметр запроса

401 Unauthorized

Не авторизованный запрос

403 Forbidden

У пользователя нет разрешения WorkspaceTimeMetrics в пространстве и разрешения WorkitemContentRead на задачу

404 Not Found

Метрика с указанным идентификатором не найдена

500 Server Error

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