Task

Task / Tasks

Сущность представляет задачу (issue). Задача всегда привязана к проекту, может иметь родителя (входить в иерархию подзадач), наблюдателей, кастомные поля, прикреплённое описание в формате RTE (HTML) и кастомные поля.


Сервис разделён на два endpoint-а: Task — операции над одной задачей и одиночное чтение, Tasks — выборка коллекции и связанные справочные объекты.


Ключи задачи

Задачу можно идентифицировать одним из трёх ключей:

Ключ Тип Описание
TaskIDNVARCHAR(10)Внутренний суррогатный идентификатор
TaskKeyNVARCHAR(128)Бизнес-ключ вида <ProjectCode>-<TaskNumber> (например, PROJ-42)
IntegrationIDNVARCHAR(128)Внешний идентификатор из интегрированной системы


Базовый URL

https://<host>/api/v01/Task
https://<host>/api/v01/Tasks


Карта endpoints

Метод URL Назначение Транспорт
GET/api/v01/Task/odata/Task(ID='…',TaskKeyField='…')Чтение одной задачиOData
GET/api/v01/Task/odata/TaskCustomFields(…)Кастомные поля одной задачиOData
GET/api/v01/Tasks/odata/TasksСписок задачOData
GET/api/v01/Tasks/odata/TaskCustomFieldsКастомные поля по задачамOData
GET/api/v01/Tasks/odata/StatusesСправочник статусовOData
GET/api/v01/Tasks/odata/TypesСправочник типов задачOData
GET/api/v01/Tasks/odata/PrioritiesСправочник приоритетовOData
GET/api/v01/Tasks/odata/ResolutionsСправочник резолюцийOData
GET/api/v01/Tasks/odata/ComponentsСправочник компонентов проектаOData
GET/api/v01/Tasks/odata/LabelsСправочник метокOData
GET/api/v01/Tasks/odata/VersionsСправочник версий (fix-versions)OData
GET/api/v01/Tasks/odata/WatchersПодписчики задачOData
GET/api/v01/Tasks/odata/ProjectsСписок проектов, доступных пользователюOData
POST/api/v01/Task/rest/CreateСоздать задачуREST
POST/api/v01/Task/rest/UpdateОбновить задачуREST
POST/api/v01/Task/rest/DeleteУдалить задачуREST