WORKSECTION

Метки

Получение списка тегов для заданий через API: get_task_tags

Пример get_task_tags запроса

?action=get_task_tags
Возвращает данные по тегам для заданий

Необязательные параметры:
  • group — фильтр по набору тегов
    Можно указывать название набора или ID набора (можно получить через этот же метод в возвращенном массиве group или через метод get_task_tag_groups)
  • type — фильтр по типу набора тегов, возможные значения: status, label
  • access — фильтр по видимости набора тегов, возможные значения:
      • public — доступен всем командам (в том числе клиентским)
      статусы всегда видимы и имеют значение public
      private — доступен только для внутренних команд компании
Возвращаемые данные:
  • id — ID тега
  • title — название тега
  • group — информация о наборе тегов

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "LABEL_NAME",
            "id": "LABEL_ID",
            "group": {
                "title": "GROUP_NAME",
                "id": GROUP_ID,
                "type": "label",
                "access": "public"
                 }
        },
        {
            "title": "STATUS_NAME",
            "id": "STATUS_ID",
            "group": {
                "title": "GROUP_NAME",
                "id": GROUP_ID,
                "type": "status",
                "access": "public"
             }
        }
    ]
}

Эта статья была вам полезна? Да, спасибо! Нет

Создание тегов для заданий через API: add_task_tags

Пример add_task_tags запроса

?action=add_task_tags&title=LABEL_NAME_1,LABEL_NAME_2&group=GROUP_ID
Создает теги для заданий в выбранном наборе тегов
*при отсутствие тегов с аналогичным названием

Обязательные параметры:
  • group — набор тегов, в котором необходимо создать теги
    Можно указывать название набора или ID набора (можно получить через этот же метод в возвращенном массиве group или через метод get_task_tag_groups)
  • title — названия тегов (через запятую)
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "LABEL_NAME_1",
            "id": LABEL_ID
        },
        {
            "title": "LABEL_NAME_2",
            "id": LABEL_ID
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Установка/снятие тегов у задания через API: update_task_tags

Пример update_task_tags запроса

?action=update_task_tags&id_task=TASK_ID&plus=Tag1,Tag2&minus=Tag3,Tag4
Установка новых и снятие старых тегов у выбранного задания

Обязательные параметры:
  • id_task — ID задания

Необязательные параметры:
*теги можно указывать по их названиям (полное совпадение) или ID (можно получить через метод get_task_tags)
  • plus — список тегов (через запятую), которые необходимо установить
  • minus — список тегов (через запятую), которые необходимо снять 
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok

{
    "status": "ok"
}

Эта статья была вам полезна? Да, спасибо! Нет

Получение списка наборов тегов для заданий через API: get_task_tag_groups

Пример get_task_tag_groups запроса

?action=get_task_tag_groups
Возвращает данные по наборам тегов для заданий

Необязательные параметры:
  • type — фильтр по типу набора тегов, возможные значения: status, label
  • access — фильтр по видимости набора тегов, возможные значения:
      • public — доступен всем командам (в том числе клиентским)
      статусы всегда видимы и имеют значение public
      private — доступен только для внутренних команд компании
Возвращаемые данные: 
  • id — ID набора тегов
  • title — название набора тегов
  • type — типа набора тегов
  • access — видимость набора тегов

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "GROUP_NAME_1",
            "id": GROUP_ID,
            "type": "status",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_2",
            "id": GROUP_ID,
            "type": "label",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_3",
            "id": GROUP_ID,
            "type": "label",
            "access": "private"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание наборов тегов для заданий через API: add_task_tag_groups

Пример add_task_tag_groups запроса

?action=add_task_tag_groups&title=GROUP_NAME_1,GROUP_NAME_2&
type=label&access=public
Создает набор тегов для заданий
*при отсутствие наборов с аналогичным названием

Обязательные параметры:
  • title — названия наборов тегов (через запятую)
  • type — тип набора тегов, возможные значения: status, label  
  • access — видимость набора тегов (статусы всегда видимы и имеют значение public)
      • public — доступен всем командам (в том числе клиентским)
      private — доступен только для внутренних команд компании
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "GROUP_NAME_1",
            "id": GROUP_ID,
            "type": "label",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_2",
            "id": GROUP_ID,
            "type": "status",
            "access": "public"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Получение списка тегов для проектов через API: get_project_tags

Пример get_project_tags запроса

?action=get_project_tags
Возвращает данные по тегам для проектов

Необязательные параметры:
  • group — фильтр по набору тегов
    Можно указывать название набора или ID набора (можно получить через этот же метод в возвращенном массиве group или через метод get_project_tag_groups)
  • type — фильтр по типу набора тегов, возможные значения: status, label
  • access — фильтр по видимости набора тегов, возможные значения:
      • public — доступен всем командам (в том числе клиентским)
      private — доступен только для внутренних команд компании
Возвращаемые данные:
  • id — ID тега
  • title — название тега
  • group — информация о наборе тегов

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
        "data": [
            {
                "title": "PROJECT_STATUS_NAME_1",
                "id": "PROJECT_STATUS_ID",
                "group": {          
                    "title": "PROJECT_GROUP_NAME",
                    "id": "PROJECT_GROUP_ID",
                    "type": "status",
                    "access": "public"
            },
            {
                "title": "_PROJECT_LABEL_NAME_2",
                "id": "PROJECT_LABEL_ID",
                "group": {             
                    "title": "PROJECT_GROUP_NAME",
                    "id": "PROJECT_GROUP_ID",
                    "type": "label",
                    "access": "public"
            }
        ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание тегов для проектов через API: add_project_tags

Пример add_project_tags запроса

?action=add_project_tags&title=PROJECT_LABEL_NAME_1,PROJECT_LABEL_NAME_2&
group=PROJECT_GROUP_ID
Создает теги для проектов в выбранном наборе тегов
*при отсутствие тегов с аналогичным названием

Обязательные параметры:
  • group — набор тегов, в котором необходимо создать теги
    Можно указывать название набора или ID набора (можно получить через этот же метод в возвращенном массиве group или через метод get_project_tag_groups)
  • title — названия тегов (через запятую)
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{ 
    "status": "ok",
    "data": [
        {
            "title": "PROJECT_LABEL_NAME_1",
            "id": PROJECT_LABEL_ID
        },
        {
            "title": "PROJECT_LABEL_NAME_2",
            "id": PROJECT_LABEL_ID
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Установка/снятие тегов у проекта через API: update_project_tags

Пример update_project_tags запроса

?action=update_project_tags&id_project=PROJECT_ID&
plus=Tag1,Tag2&minus=Tag3,Tag4
Установка новых и снятие старых тегов у выбранного проекта

Обязательные параметры:
  • id_project — ID проекта

Необязательные параметры:
*теги можно указывать по их названиям (полное совпадение) или ID (можно получить через метод get_project_tags)
  • plus — список тегов (через запятую), которые необходимо установить
  • minus — список тегов (через запятую), которые необходимо снять 
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok

{
    "status": "ok",
}
Эта статья была вам полезна? Да, спасибо! Нет

Получение списка наборов тегов для проектов через API: get_project_tag_groups

Пример get_project_tag_groups запроса

?action=get_project_tag_groups
Возвращает данные по проектным наборам тегов

Необязательные параметры:
  • type — фильтр по типу набора тегов, возможные значения: status, label
  • access — фильтр по видимости набора тегов, возможные значения:
      • public — доступен всем командам (в том числе клиентским)
      private — доступен только для внутренних команд компании
Возвращаемые данные: 
  • id — ID набора тегов
  • title — название набора тегов
  • type — тип набора тегов   
  • access — видимость набора меток

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "GROUP_NAME_1",
            "id": GROUP_ID,
            "type": "status",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_2",
            "id": GROUP_ID,
            "type": "label",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_3",
            "id": GROUP_ID,
            "type": "label",
            "access": "private"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет

Создание набора тегов для проектов через API: add_project_tag_groups

Пример add_project_tag_groups запроса

?action=add_project_tag_groups&title=GROUP_NAME_1,GROUP_NAME_2&
type=label&access=public
Создает проектные наборы тегов
*при отсутствие наборов с аналогичным названием

Обязательные параметры:
  • title — названия наборов меток (через запятую)  
  • access — видимость набора меток, возможные значения:
      • public — доступен всем командам (в том числе клиентским)
      private — доступен только для внутренних команд компании
Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
    "status": "ok",
    "data": [
        {
            "title": "GROUP_NAME_1",
            "id": GROUP_ID,
            "type": "",
            "access": "public"
        },
        {
            "title": "GROUP_NAME_2",
            "id": GROUP_ID,
            "type": "",
            "access": "public"
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет
Вторжение России в Украину Worksection прекратил работу на территории РФ Почему?
esc
или
Распечатать