Задачи¶
CRUD-операции¶
Список задач¶
URI: /BumsTaskApiV01/Task/list.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Folder | string | Папка | Допустимые значения: 
 По умолчанию: all | 
| TimeUpdated | string | Возвращать только те объекты, которые были изменены после указанный даты | Дата/время в одном из форматов ISO 8601 | 
| Status | string | Статус | Допустимые значения: 
 По умолчанию: any | 
| FavoritesOnly | integer | Только избранное | Допустимые значения: 0, 1. По умолчанию: 0 | 
| Search | string | Строка поиска показывать в списке задач все поля из карточки задачи | Допустимые значения: true, false По умолчанию: false | 
| OnlyActual | bool | Если true, то будут выводиться только незавершенные задачи | Допустимые значения: true, false По умолчанию: false | 
| FilterId | string | Код фильтра | Допустимые значения: любая строка (может быть как числом, так и строковым идентификатором) | 
| Count | bool | Если передан этот параметр со значением true, то вместо списка будет выводиться только количество задач, удовлетворяющих условиям | Допустимые значения: true, false По умолчанию: false | 
| EmployeeId | integer | Код сотрудника, для которого нужно загрузить задачи | |
| ProjectId | integer | Возвращает только задачи, входящие в проект ProjectId | |
| SuperTaskId | integer | Возвращает только задачи, входящие в надзадачу SuperTaskId | |
| SortBy | string | Сортировка результата | Допустимые значения: 
 | 
| SortOrder | string | Направление сортировки | Допустимые значения: 
 По умолчанию: asc | 
| ShowActions | bool | Нужно ли показывать в списке возможные действия над задачей | Допустимые значения: true, false По умолчанию: false | 
| Limit | integer | Сколько выбрать задач (LIMIT) | Целочисленное значение в диапазоне [1,100] По умолчанию: 50 | 
| Offset | integer | Начиная с какой выбирать задачи (OFFSET) | |
| Detailed | bool | Если true, то будут выводиться поля подробной информации о задаче | К таким полям относятся: Statement, Executors, Auditors, AllAttaches, Start, PlannedWork, PlannedFinish, Finish, ActualWork, ActualWorkWithSubTasks | 
Все параметры являются необязательными
Выходные данные (массив задач с полями)¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID задачи | 
| Name | string | Название | 
| Status | string | Статус | 
| PlannedFinish | datetime | Дата запланированного финиша | 
| PlannedWork | integer | Количество запланированной работы в минутах | 
| ActualWork | integer | Отработанное время в минутах | 
| ActualWorkWithSubTasks | integer | Аналогично ActualWork, но с учетом отработанного времени во всех подзадачах | 
| Completed | integer | Процент завершения задачи | 
| Deadline | datetime | Дедлайн | 
| Owner | object | Постановщик (сотрудник) | 
| Owner.Id | integer | Идентификатор | 
| Owner.Name | string | Имя | 
| Responsible | object | Ответственный (сотрудник) | 
| Responsible.Id | integer | Идентификатор | 
| Responsible.Name | string | Имя | 
| Severity | string | Важность | 
| SuperTask | object | Надзадача | 
| SuperTask.Id | integer | Идентификатор | 
| SuperTask.Name | string | Название | 
| Project | object | Проект | 
| Project.Id | integer | Идентификатор | 
| Project.Name | string | Название | 
| Favorite | integer | В избранном | 
| TimeCreated | datetime | Время создания | 
| TimeUpdated | datetime | Время последней модификации | 
| Folders | array | Список папок, в которые попадает задача | 
| Tags | object[] | Тэги, привязанные к задаче | 
| Tags[].Id | integer | Идентификатор | 
| Tags[].Name | string | Имя тега | 
| Activity | datetime | Дата и время последней активности по задаче | 
| Actions | array | Список доступных действий над задачей | 
| IsOverdue | bool | Является ли задача просроченной | 
| СommentsUnread | integer | Количество непрочитанных комментариев | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "params":
  {
    "Folder":"all",
    "Status":"any"
  },
  "data":
  {
    "tasks":
    [
      {
        "Id":841,
        "Name":"Test task",
        "Status":"accepted",
        "Deadline":"2010-12-30 16:00:00",
        "Owner":
        {
          "Id":2,
          "Name":"Director"
        },
        "Responsible":
        {
          "Id":651,
          "Name":"Ivanov Ivan"
        },
        "Favorite":"",
        "TimeCreated":"2007-12-13 12:24:12",
        "IsOverdue":true
      },
      {
        "Id":1394,
        "Name":"Another task",
        "Status":"accepted",
        "Deadline":"",
        "Owner":
        {
          "Id":3,
          "Name":"Medvedev Dima"
        },
        "Responsible":
        {
          "Id":651,
          "Name":"Ivanov Ivan"
        },
        "Severity":
        {
          "Id":1,
          "Name":"Hot"
        },
        "SuperTask":
        {
          "Id":1393,
          "Name":"Global task"
        },
        "Project":
        {
          "Id":30,
          "Name":"Megaplan API"
        },
        "Favorite":"1",
        "TimeCreated":"2009-08-17 13:27:28",
        "Folders":["incoming"]
        "IsOverdue":false
      }
    ]
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <params>
    <folder>all</folder>
    <status>any</status>
  </params>
  <data>
    <tasks>
      <item>
        <id>841</id>
        <name>Test task</name>
        <status>accepted</status>
        <deadline>2010-12-30 16:00:00</deadline>
        <owner>
          <id>2</id>
          <name>Director</name>
        </owner>
        <responsible>
          <id>651</id>
          <name>Ivanov Ivan</name>
        </responsible>
        <time_created>2007-12-13 12:24:12</time_created>
        <folders>
          <item>incoming</item>
        </folders>
        <is_overdue>true</is_overdue>
      </item>
      <item>
        <id>1394</id>
        <name>Another task</name>
        <status>accepted</status>
        <deadline></deadline>
        <owner>
          <id>3</id>
          <name>Medvedev Dima</name>
        </owner>
        <responsible>
          <id>651</id>
          <name>Ivanov Ivan</name>
        </responsible>
        <severity>
          <id>1</id>
          <name>Hot</name>
        </severity>
        <super_task>
          <id>1393</id>
          <name>Global task</name>
        </super_task>
        <project>
          <id>30</id>
          <name>Megaplan API</name>
        </project>
        <favorite>1</favorite>
        <time_created>2009-08-17 13:27:28</time_created>
        <folders>
          <item>incoming</item>
        </folders>
        <is_overdue>true</is_overdue>
      </item>
    </tasks>
  </data>
</response>
Создание задачи¶
URI: /BumsTaskApiV01/Task/create.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Model[Name] | string | Название | Обязательное поле | 
| Model[Deadline] | datetime | Дедлайн (дата со временем) | |
| Model[DeadlineDate] | date | Дедлайн (только дата) | |
| Model[DeadlineType] | string | Тип дедлайна | |
| Model[Responsible] | integer | Код ответственного | Обязательное поле для не массовой задачи | 
| Model[Executors] | integer[] | Коды соисполнителей | Обязательное поле для массовой задачи | 
| Model[Auditors] | integer[] | Коды аудиторов | |
| Model[Severity] | integer | Код важности | |
| Model[SuperTask] | string | Код надзадачи (если число) или код проекта (если строка в формате „pКод_проекта“) | |
| Model[Customer] | integer | Код заказчика | |
| Model[IsGroup] | integer | Массовая задача (каждому соисполнителю будет создана своя задача) | Допустимые значения: 0 или 1 | 
| Model[Statement] | string | Суть задачи | |
| Model[Attaches][Add] | array | Массив приложенных файлов | Должен передаваться POST-запросом | 
| Model[Attaches][Add][0…n][Content] | string | Данные (контент) файла, закодированные с использованием MIME base64 | В устаревших версиях Мегаплана может действовать имя параметра Model[Attaches][Add][][Context] | 
| Model[Attaches][Add][0…n][Name] | string | Имя файла | Будет фигурировать при выводе задачи | 
| Model[Start] | datetime | Планирование: старт | Дата со временем | 
| Model[PlannedFinish] | date | Планирование: финиш | Только дата. При указанном Model[PlannedTime] расчитывается автоматически | 
| Model[PlannedTime] | integer | Планирование: длительность (в днях) | При указанном Model[PlannedFinish] расчитывается автоматически | 
| Model[PlannedWork] | integer | Планирование: плановые трудозатраты (в минутах) | 
Выходные данные (поля созданной задачи)¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | При постановке массовой задачи это будет ID родительской надзадачи | 
| Name | string | Название задачи | 
Редактирование задачи¶
URI: /BumsTaskApiV01/Task/edit.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
| Model[Name] | string | Название | |
| Model[Deadline] | datetime | Дедлайн (дата со временем) | |
| Model[DeadlineDate] | date | Дедлайн (только дата) | |
| Model[DeadlineType] | string | Тип дедлайна | |
| Model[Owner] | integer | Код постановщика | |
| Model[Responsible] | integer | Код ответственного | |
| Model[Executors] | integer[] | Коды соисполнителей | |
| Model[Auditors] | integer[] | Коды аудиторов | |
| Model[Severity] | integer | Код важности | С версии 2011.3 допустимо отсутствие параметра важности или важность с MasterType=high | 
| Model[SuperTask] | string | Код надзадачи (если число) или код проекта (если строка в формате „pКод_проекта“) | |
| Model[Customer] | integer | Код заказчика | |
| Model[Statement] | string | Суть задачи | |
| Model[Attaches][Add] | array | Массив приложенных файлов | Должен передаваться POST-запросом | 
| Model[Attaches][Add][0…n][Content] | string | Данные (контент) файла, закодированные с использованием MIME base64 | В устаревших версиях Мегаплана может действовать имя параметра Model[Attaches][Add][][Context] | 
| Model[Attaches][Add][0…n][Name] | string | Имя файла | Будет фигурировать при выводе задачи | 
| Model[Start] | datetime | Планирование: старт | Дата со временем | 
| Model[PlannedFinish] | date | Планирование: финиш | Только дата. При указанном Model[PlannedTime] расчитывается автоматически | 
| Model[PlannedTime] | integer | Планирование: длительность (в днях) | При указанном Model[PlannedFinish] расчитывается автоматически | 
| Model[PlannedWork] | integer | Планирование: плановые трудозатраты (в минутах) | 
Выходные данные¶
–
Редактирование Аудиторов¶
URI: /BumsTaskApiV01/Task/saveAuditors.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
| Auditors | integer[] | Идентификаторы аудиторов | При пустом параметре аудиторы будут сброшены | 
Редактирование Соисполнителей¶
URI: /BumsTaskApiV01/Task/saveExecutors.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
| Executors | integer[] | Идентификаторы соисполнителей | При пустом параметре соисполнители будут сброшены | 
Карточка задачи¶
URI: /BumsTaskApiV01/Task/card.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID задачи (обязательный параметр) | 
| RequestedFields | array | Запрашиваемые поля (меняет набор полей по умолчанию). Могут содержать расширенные поля. | 
| ExtraFields | array | Дополнительные поля (дополняют набор полей по умолчанию). Могут содержать расширенные поля. | 
Выходные данные (поля задачи)¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID задачи | 
| Name | string | Название | 
| Statement | string | Суть задачи | 
| Status | string | Статус Возможные статусы задачи: 
 | 
| Start | datetime | Старт задачи | 
| Completed | integer | Процент завершения задачи | 
| Finish | datetime | Время фактического завершения задачи | 
| PlannedFinish | datetime | Дата запланированного финиша | 
| PlannedWork | integer | Количество запланированной работы в минутах | 
| ActualWork | integer | Отработанное время в минутах | 
| ActualWorkWithSubTasks | integer | Аналогично ActualWork, но с учетом отработанного времени во всех подзадачах | 
| Completed | integer | Процент завершения задачи | 
| Deadline | datetime | Дедлайн | 
| Owner | object | Постановщик (сотрудник) | 
| Owner.Id | integer | Идентификатор | 
| Owner.Name | string | Имя | 
| Responsible | object | Ответственный (сотрудник) | 
| Responsible.Id | integer | Идентификатор | 
| Responsible.Name | string | Имя | 
| Executors | object[] | Соисполнители (сотрудники) | 
| Executors[].Id | integer | Идентификатор | 
| Executors[].Name | string | Имя | 
| Auditors | object[] | Аудиторы (сотрудники) | 
| Auditors[].Id | integer | Идентификатор | 
| Auditors[].Name | string | Имя | 
| Severity | string | Важность | 
| SuperTask | object | Надзадача | 
| SuperTask.Id | integer | Идентификатор | 
| SuperTask.Name | string | Название | 
| Project | object | Проект | 
| Project.Id | integer | Идентификатор | 
| Project.Name | string | Название | 
| Favorite | integer | В избранном | 
| TimeCreated | datetime | Время создания | 
| TimeUpdated | datetime | Время последней модификации | 
| Customer | object | Заказчик | 
| Customer.Id | integer | Идентификатор | 
| Customer.Name | string | Название | 
| Customer.Status | array | Cтатус | 
| Customer.Status.Id | integer | Идентификатор | 
| Customer.Status.Name | string | Название | 
| Customer.Type | array | Тип | 
| Customer.Type.Id | integer | Идентификатор | 
| Customer.Type.Name | string | Название типа | 
| DeadlineChange | object | Неотвеченный запрос на перенос дедлайна | 
| DeadlineChange.Id | integer | Идентификатор запроса | 
| DeadlineChange.Request | string | Объяснение запроса | 
| DeadlineChange.Deadline | datetime | Дата-время нового дедлайна | 
| Folders | array | Список папок, в которые попадает задача | 
| Tags | object[] | Тэги, привязанные к задаче | 
| Tags[].Id | integer | Идентификатор | 
| Tags[].Name | string | Название | 
| Activity | datetime | Дата и время последней активности по задаче | 
| IsOverdue | bool | Является ли задача просроченной | 
| Attaches | object[] | Прикрепленные к задаче файлы | 
| Attaches[].Name | string | Пользовательское имя файла | 
| Attaches[].Url | string | Ссылка для скачивания файла (без домена) | 
| Attaches[].FileName | string | Физическое имя файла | 
| Attaches[].TimeCreated | datetime | Дата-время добавления аттача | 
| Attaches[].Size | integer | Размер файла в байтах | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "params":
  {
    "Id":841
  },
  "data":
  {
    "task":
    {
      "Id":841,
      "Folders":["incoming"],
      "Name":"Test task",
      "Statement":"Task statement",
      "Status":"accepted",
      "Deadline":"2010-12-30 16:00:00",
      "DeadlineType":"medium",
      "Owner":
      {
        "Id":2,
        "Name":"Director"
      },
      "Responsible":
      {
        "Id":651,
        "Name":"Ivanov Ivan"
      },
      "Executors":
      [
        {
          "Id":44,
          "Name":"Sidorov Sidor"
        },
        {
          "Id":45,
          "Name":"VV"
        }
      ],
      "Favorite":"1",
      "TimeCreated":"2007-12-13 12:24:12",
      "DeadlineChange":
      {
        "Id":621,
        "Request":"Не успеваю",
        "Deadline":"2012-02-04"
      },
      "IsOverdue":true
    }
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <params>
    <id>841</id>
  </params>
  <data>
    <task>
      <id>841</id>
      <name>Test task</name>
      <statement>Some task statement with "html special chars"</statement>
      <status>accepted</status>
      <deadline>2010-12-30 16:00:00</deadline>
      <deadline_type>medium</deadline_type>
      <folders>
        <item>incoming</item>
      </folders>
      <owner>
        <id>2</id>
        <name>Director</name>
      </owner>
      <responsible>
        <id>651</id>
        <name>Ivanov Ivan</name>
      </responsible>
      <executors>
        <item>
          <id>44</id>
          <name>Sidorov Sidor</name>
        </item>
        <item>
          <id>45</id>
          <name>VV</name>
        </item>
      </executors>
      <favorite>1</favorite>
      <time_created>2007-12-13 12:24:12</time_created>
      <deadline_change>
        <id>621</id>
        <request>Не успеваю</request>
        <deadline>2012-02-04</deadline>
      </deadline_change>
      <is_overdue>true</is_overdue>
    </task>
  </data>
</response>
Другие действия¶
Совершение действия над задачей¶
URI: /BumsTaskApiV01/Task/action.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID задачи | 
| Action | string | Действие над задачей | 
Выходные данные¶
–
Может ли пользователь делегировать задачу¶
URI: /BumsTaskApiV01/Task/checkDelegate.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи, которую нужно делегировать | Обязательный параметр | 
| ResponsibleId | integer | Идентификатор сотрудника, которому нужно делегировать задачу | Обязательный параметр | 
Выходные данные¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| CanDelegate | bool | Может ли текущий пользователь делегировать задачу | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "data":
  {
    "CanDelegate": 1
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <data>
    <can_delegate>1</can_delegate>
  </data>
</response>
Конвертация задачу в проект¶
URI: /BumsTaskApiV01/Task/convert.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
Выходные данные (поля проекта)¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID проекта | 
Запрос на перенос дедлайна¶
URI: /BumsTaskApiV01/Task/deadlineChange.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| SubjectId | integer | ID задачи или проекта | Обязательный параметр | 
| SubjectType | string | Тип объекта | Допустимые значения: 
 Обязательный параметр | 
| Deadline | datetime | Новая дата дедлайна | |
| Request | string | Комментарий к запросу | 
Выходные данные¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| createdDeadlineChangeId | integer | ID запроса на смену дедлайна | 
Принять или отклонить запрос на изменение дедлайна¶
URI: /BumsTaskApiV01/Task/deadlineAction.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID запроса | Идентификатор запроса. Выводится в карточке задачи, к которой привязан запрос. Обязательный параметр | 
| Action | string | Действие над запросом | Допустимые значения: принять ( act\_accept\_deadline) и отклонить (
(act\_reject\_deadline) | 
Делегирование задачи¶
URI: /BumsTaskApiV01/Task/delegate.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи, которую нужно делегировать | Обязательный параметр | 
| ResponsibleId | integer | Идентификатор сотрудника, которому нужно делегировать задачу | Обязательный параметр | 
Делегировать можно:
- Задачи в статусе «назначена» и «принята», в которых постановщик или ответственный является вашим подчиненным.
- Задачи в статусе «назначена» и «принята», принадлежащие проекту, в котором вы являетесь менеджером.
Добавить задачу в избранное¶
URI: /BumsTaskApiV01/Task/markAsFavorite.api|xml
Для добавления и удаления из избранного предпочтительно пользоваться командами `Добавить в избранное <API_favorite_add>`__ и `Удалить из избранного <API_favorite_remove>`__
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
| Value | integer | Действие | Допустимые значения: 
 | 
Метаинформация¶
Список возможных действий над задачей¶
| Название | Описание | 
|---|---|
| act_accept_task | принять задачу | 
| act_reject_task | отклонить задачу | 
| act_accept_work | принять работу | 
| act_reject_work | отклонить работу | 
| act_done | завершить задачу | 
| act_pause | поставить на паузу | 
| act_resume | возобновить задачу | 
| act_cancel | снять задачу | 
| act_expire | провалить задачу | 
| act_renew | возобновить задачу | 
| act_delete | удалить задачу | 
| act_edit | редактировать задачу | 
| act_convert | преобразовать задачу в проект | 
| act_subtask | создать подзадачу | 
| act_delegate | делегировать задачу | 
| act_edit_executors | изменение соисполнителей и аудиторов | 
Список действий для задачи¶
URI: /BumsTaskApiV01/Task/availableActions.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи | Обязательный параметр | 
Выходные данные¶
| Имя поля | Тип | Описание | 
|---|---|---|
| actions | string[] | Массив с названиями допустимых действий | 
Пример ответа в JSON-формате¶
{
    "status": {
        "code":"ok",
        "message":null
    },
    "actions":["act_delete","act_edit","act_accept_work","act_cancel"]
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
    <status>
        <code>ok</code>
        <message></message>
    </status>
    <actions>
        <item>act_delete</item>
        <item>act_edit</item>
        <item>act_accept_work</item>
        <item>act_cancel</item>
    </actions>
</response>
Список действий для нескольких задач¶
URI: /BumsTaskApiV01/Task/availableActionsForList.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Ids | array | Массив идентификаторов, для которых нужно загрузить список действий | 
Выходные данные¶
| Имя поля | Тип | Описание | 
|---|---|---|
| actions | object[] | Массив с ID задач и допустимых действий для них | 
| actions[].Id | integer | Идентификатор задачи | 
| actions[].Actions | string[] | Массив с названиями допустимых действий | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
   "actions":
  [
    {
      "Id": 540,
      "Actions":
      [
        "act_edit",
        "act_done"
      ]
    },
    {
      "Id": 541,
      "Actions":
      [
        "act_expire",
        "act_delete"
      ]
    }
  ]
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <actions>
    <item>
      <id>540</id>
      <actions>
        <item>act_edit</item>
        <item>act_done</item>
      </actions>
    </item>
    <item>
      <id>541</id>
      <actions>
        <item>act_expire</item>
        <item>act_delete</item>
      </actions>
    </item>
  </actions>
</response>
</response>
Список проектов, которые можно указывать в качестве надпроектов¶
URI: /BumsTaskApiV01/Task/superProjects.api|xml
Выходные данные (список проектов)¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID проекта | 
| Name | string | Название | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "params":
  {
  },
  "data":
  {
    "projects":
    [
      {
        "Id":841,
        "Name":"Test task"
      },
      {
        "Id":1394,
        "Name":"Another task"
      }
    ]
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <params>
  </params>
  <data>
    <projects>
      <item>
        <id>841</id>
        <name>Test project</name>
      </item>
      <item>
        <id>1394</id>
        <name>Another project</name>
      </item>
    </projects>
  </data>
</response>
Список задач и проектов, которые можно указывать в качестве родителя¶
URI: /BumsTaskApiV01/Task/superTasks.api|xml
Входные параметры¶
–
Выходные данные (список задач)¶
| Имя поля | Тип | Описание | 
|---|---|---|
| Id | integer | ID задачи | 
| Name | string | Название | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "params":
  {
  },
  "data":
  {
    "tasks":
    [
      {
        "Id":841,
        "Name":"Test task"
      },
      {
        "Id":1394,
        "Name":"Another task"
      }
    ],
    "projects":
    [
      {
        "Id":45,
        "Name":"Test project"
      },
      {
        "Id":63,
        "Name":"Another project"
      }
    ]
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <params>
  </params>
  <data>
    <tasks>
      <item>
        <id>841</id>
        <name>Test task</name>
      </item>
      <item>
        <id>1394</id>
        <name>Another task</name>
      </item>
    </tasks>
    <projects>
      <item>
        <id>45</id>
        <name>Test project</name>
      </item>
      <item>
        <id>63</id>
        <name>Another project</name>
      </item>
    </projects>
  </data>
</response>
Список сотрудников, которым можно делегировать задачу¶
URI: /BumsTaskApiV01/Task/employeesToDelegate.api|xml
Входные параметры¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| Id | integer | ID задачи, которую нужно делегировать | Обязательный параметр | 
Выходные данные¶
| Имя поля | Тип | Описание | Примечание | 
|---|---|---|---|
| employees | object[] | Список сотрудников которым можно делегировать задачу | |
| employees[].Id | integer | ID сотрудника | |
| employees[].Name | string | Полное имя | 
Пример ответа в JSON-формате¶
{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "params":
  {
    "Id":100234
  },
  "data":
  {
    "employees":
    [
      {
        "Id":1087,
        "Name":"Denisov Ivan"
      }
    ]
  }
}
Пример ответа в XML-формате¶
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <params>
  <id>100234</id>
  </params>
  <data>
    <employees>
      <item>
        <id>1087</id>
        <name>Denisov Ivan</name>
      </item>
    </employees>
  </data>
 </response>