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

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

?action=get_project&id_project=PROJECT_ID

Возвращает данные выбранного проекта

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

id_project — ID проекта

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

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",
        "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,
        "tags": {
            "TAG_ID": "TAG_NAME_1",
            "TAG_ID": "TAG_NAME_2"
        },
        "users": [
            {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME_1"
            },
            {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME_2"
            },
            {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME_3"
            }
        ]
    }
}