Метки

Назначение меток

URI: /BumsCommonApiV01/Tags/assign.api|xml

Входные параметры

Поле

Тип

Допустимые значения

Описание

SubjectType

string

task (задача), project (проект)

Тип объекта

SubjectIds

array

Массив из идентификаторов объектов, которые нужно пометить

TagIds

array

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

Выходные данные

Создание новой метки

URI: /BumsCommonApiV01/Tags/create.api|xml

Входные параметры

Поле

Тип

Допустимые значения

Описание

SubjectType

string

task (задача), project (проект)

Тип объекта

Model[Name]

string

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

Model[IsGlobal]

bool

Является ли новая метка глобальной

Выходные данные

Поле

Тип

Описание

Id

integer

ID метки

Name

string

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

Удалить метки

URI: /BumsCommonApiV01/Tags/delete.api|xml

Входные параметры

Параметр

Тип

Допустимые значения

Значение по умолчанию

Описание

Id

integer

идентификатор метки для удаления

Id

array<integer>

массив идентификаторов меток для удаления

Список меток

URI: /BumsCommonApiV01/Tags/list.api|xml

Входные параметры

Поле

Тип

Допустимые значения

Описание

SubjectType

string

task (задача), project (проект), event

Тип объекта

IncludeGlobal

bool

Нужно ли включать в список меток глобальные метки

Выходные данные

Поле

Тип

Описание

Id

integer

Код метки

Name

string

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

TimeCreated

datetime

Дата и время создания

IsGlobal

bool

Является ли метка глобальной, то есть не привязанной к конкретному пользователю

UserId

integer

Код пользователя, к которому привязана метка

Пример ответа в JSON-формате

{
  "status":
  {
    "code":"ok",
    "message":null
  },
  "data":
  {
    "tags":
    [
      {
        "Id":1001128,
        "Name":"Персональный тэг",
        "TimeCreated":"2011-05-17 19:26:23",
        "IsGlobal":"false",
        "UserId":100234
      },
    ]
  }
}

Пример ответа в XML-формате

<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>
    <code>ok</code>
    <message></message>
  </status>
  <data>
    <tags>
      <item>
        <id>1001128</id>
        <name>Персональный тэг</name>
        <time_created>2011-05-17 19:26:23</time_created>
        <is_global>0</is_global>
        <user_id>100234</user_id>
    </item>
    </tags>
  </data>
</response>

Список меток

URI: /BumsCommonApiV01/Tags/search.api|xml

Входные параметры

Поле

Тип

Допустимые значения

Описание

SubjectType

string

task (задача), project (проект)

Тип объекта

TagIds

array

Массив идентификаторов тэгов, по которым нужно произвести поиск

Выходные данные

Формат выходных данных зависит от типа объекта, по которому производился поиск. Описание для конкретного объекта можно найти в соответствующем разделе документации.

Обновление существующей метки

URI: /BumsCommonApiV01/Tags/update.api|xml

Входные параметры

Поле

Тип

Описание

Id

integer

Код метки

Model[Name]

string

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

Выходные данные