Вопросы и ответы - что такое Получение списка проектов через API: get_projects? Помощь пользователям информационной системы управления бизнес процессами

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

?action=get_projects

Возвращает данные по всем проектам

Необязательные параметры:

filter — состояние проекта, возможные значения: active, pending, archived
extra — дополнительные данные по проекту, возможные значения (можно указывать через запятую, например extra=text,options,users):

text или html — описание в текстовом или html формате

options — ограничения проекта

users — участники команды проекта

Возвращаемые данные:

id — ID проекта
name — название проекта
status — состояние проектастатус
company — название папки, в которой размещен проект
user_from и user_to — создатель проекта и руководитель проекта
text — описание проекта в текстовом или html формате (если в запросе указан соответствующий параметр extra)
date_added — дата и время создания
date_closed — дата и время закрытия (если проект перемещен в архив) или дата и время предыдущего закрытия (если проект активный)
date_start — дата начала проекта (если указано)
date_end — дата окончания проекта (если указано)
options — ограничения проекта со значениями 0/ 1 — отключено/включено (возвращаются, если в запросе указан параметр extra=options):

Исполнитель может:

options.allow_close — закрывать задания

options.allow_give — передавать ответственность

options.allow_term — изменять сроки задачи

options.allow_limit — изменять предполагаемые затраты

При постановке задач требовать PRO:

options.require_term — сроки

options.require_tag — статусы и метки

options.require_limit — предполагаемые затраты

options.require_hidden — видимость

Пользователям запрещено PRO:

options.deny_comments_edit — редактировать и удалять комментарии

options.deny_task_edit — редактировать и удалять задачи

options.deny_task_delete — удалять задачи

Настройка внесения затрат PRO:

options.time_require — не закрывать задачи без затрат

options.time_today — только за текущий день

options.timer_only — только с таймера

max_time и max_money — плановые временные и финансовые затраты (если указаны)

tags — массив в формате id: name для тегов проекта (если указаны)
users — участники команды проекта (если в запросе указан соответствующий параметр extra)

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

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

{
    "status": "ok",
    "data": [ 
        {
            "id": "PROJECT_ID_1",
            "name": "PROJECT_NAME",
            "page": "/project/PROJECT_ID/",
            "status": "active",
            "company": "FOLDER_NAME",
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "user_to": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "text": "PROJECT_TEXT",
            "date_added": "YYYY-MM-DD HH:II",
            "date_start": "YYYY-MM-DD",
            "date_end": "YYYY-MM-DD",
            "date_closed": "YYYY-MM-DD HH:II",
            "options": {
               "allow_close": 0..1,
               "allow_give": 0..1,
               "allow_term": 0..1,
               "allow_limit": 0..1,
               "require_term": 0..1,
               "require_tag": 0..1,
               "require_limit": 0..1,
               "require_hidden": 0..1,
               "deny_comments_edit": 0..1,
               "deny_task_edit": 0..1,
               "deny_task_delete": 0..1,
               "time_require": 0..1,
               "time_today": 0..1,
               "timer_only": 0..1
            },
            "max_time": 100,
            "max_money": 500,
            "users": [
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                }
            ]
        },
        {
            "id": "PROJECT_ID_2",
            "name": "PROJECT_NAME",
            ... ... ...
        }
    ]
}