WORKSECTION

Метки

Получение списка наименований наборов статусов/меток через API: get_tag_groups

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

https://your-domain.com/api/admin/v2/?action=get_tag_groups&hash=HASH
Возвращает данные с названиями всех наборов статусов/меток и их уникальный id.

В этом запросе параметр page не требуется
Пример JSON ответа

{
"status": "ok",
"data": [
  {
    "title":"GROUP_NAME",
    "id":"GROUP_ID",
    "type":"Status",
    "access":"public"
  },
  {
    "title": "GROUP_NAME",
    "id":"GROUP_ID",
    "type":"label",
    "access":"private"
  }
]
}

Получение списка статусов и меток через API: get_tags

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

https://your-domain.com/api/admin/v2/?action=get_tags&
group=GROUP_ID&hash=HASH
Возвращает данные о всех статусах и метках с привязкой к набору.

В этом запросе параметр page не требуется

Необязательные параметры:
  • group – id набора, возвращает данные выбранного набора 
Пример JSON ответа

{
"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_tag_groups

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

https://your-domain.com/api/admin/v2/?action=add_tag_groups&
title=GROUP_NAME_1,GROUP_NAME_2&type=label&access=public&hash=HASH
Проверяет на возможное существование группы статусов/меток, и создает новую, если необходимо

Обязательные параметры:
  • type – label или status
  • access – public или private
  • title – список групп меток/статусов разделенных запятой 
При успешном выполнении, ответ будет содержать статус ок и данные
{
"status":"ok",
"data":[
  {"title":"GROUP_NAME_1","id":GROUP_ID,"type":"label","access":"public"},
  {"title":"GROUP_NAME_2","id":GROUP_ID,"type":"label","access":"public"}
]
}

Создание статусов и меток через API: add_tags

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

https://your-domain.com/api/admin/v2/?action=add_tags&
title=LABEL_NAME_1,LABEL_NAME_2&group=GROUP_ID&hash=HASH
Проверяет на возможное существование статусов/меток, и создает новые, если необходимо

Обязательные параметры:
  • group – ID группы или наименование
  • title – список статусов или меток разделенных запятой
При успешном выполнении, ответ будет содержать статус ок и данные
{
"status":"ok",
"data":[
  {"title":"LABEL_NAME_1","id":"LABEL_ID"},
  {"title":"LABEL_NAME_2","id":"LABEL_ID"}
]
}

Установка/удаление статусов и меток задачам через API: update_tags

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

https://your-domain.com/api/admin/v2/?action=update_tags&
page=/project/PROJECT_ID/TASK_ID/&plus=Tag1,Tag2&minus=Tag3,
Tag4&hash=HASH
Установка новых и удаление старых статусов или меток задач.
Статусы и метки можно указывать по их названиям (полное совпадение) или ID.

Обязательные параметры:
  • page – адрес задачи /подзадачи 

Необязательные параметры:
  • plus – список меток разделенных запятой, которые будут назначены
  • minus – список меток разделенных запятой, которые будут сняты 
При успешном выполнении запроса, ответ будет содержать статус Ок
{
"status": "ok"
}

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

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

https://your-domain.com/api/admin/v2/?action=get_project_tags&hash=HASH
Возвращает данные с наименованиями всех проектных статусов/меток их принадлежности к набору и уникальный id.

В этом запросе параметр page не требуется
Пример JSON ответа

"status": "ok",
    "data": [
        {
           "title": "PROJECT_STATUS_NAME",
            "id": "PROJECT_STATUS_ID",
            "group":{          
               "title": "PROJECT_GROUP_NAME",
               "id": "PROJECT_GROUP_ID",
               "type": "status",
               "access": "public"
            },
            "title": "_PROJECT_LABEL_NAME",
            "id": "PROJECT_LABEL_ID",
            "group":{             
               "title": "PROJECT_GROUP_NAME",
               "id": "PROJECT_GROUP_ID",
               "type": "label",
               "access": "public"
            }
         }
]

Создание проектных статусов и меток через API: add_project_tags

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

https://your-domain.com/api/admin/v2/?action=add_project_tags&title=
PROJECT_LABEL_NAME_1,PROJECT_LABEL_NAME_2&group=PROJECT_GROUP_ID&hash=HASH
Проверяет на возможное существование проектных статусов/меток, создает новые, если необходимо.

Обязательные параметры:
  • group – ID группы или наименование
  • title – список статусов или меток разделенных запятой
При успешном выполнении, ответ будет содержать статус ок и данные

{ 
"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 запроса

https://your-domain.com/api/admin/v2/?action=update_project_tags&page=
/project/PROJECT_ID/&plus=Tag1,Tag2&minus=Tag3,Tag4&hash=HASH
Установка новых и удаление старых статусов или меток проекта

Статусы и метки можно указывать по названиям (полное совпадение) или уникальным ID

Обязательные параметры:
  • page – адрес проекта 
Необязательные параметры:
  • plus – список статусов/меток разделенных запятой, которые будут назначены проекту
  • minus – список статусов/меток разделенных запятой, которые будут сняты с проекта
При успешном выполнении запроса, ответ будет содержать статус ok

{
    "status": "ok",
}
esc
или
Распечатать