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

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

?action=get_events&period=3d

Возвращает данные по выполненным действиям по всем или отдельному проекту за указанный период времени
*что, когда и кем изменено

Советуем использовать вебхуки вместо этого метода (см. детальнее)

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

period — период времени, возможные значения (только целые числа):
в минутах 1m..360m, в часах 1h..72h, в днях 1d..30d)

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

id_project — ID проекта

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

action — выполненное действие:

post — создание нового проекта/задания/комментария

update — редактирование параметров проекта/задания/комментария

close — закрытие задания

reopen — переоткрытие задания

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

object — объект, над которым произведены указанные в action действия:

type — тип объекта: project, task и comment

id — ID объекта

page — ссылка на объект

date_added — дата и время совершения действия
user_from — пользователь, который совершил действие
new — текущие или обновленные значения параметров

для action = post это названия указанных при создании параметров нового объекта и их значения

для action = update это название параметров, которые изменялись, и их новые значения

old — название параметров, которые изменялись, и их предыдущие значения (только для action = update)

Пример JSON ответа
*показан для двух выполненных действий: редактирование комментария и изменение срока завершения задачи

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

{
    "status": "ok",
    "data": [
        {
            "action": "update",
            "object": {
                "type": "comment",
                "id": "COMMENT_ID",
                "page": "/project/PROJECT_ID/TASK_ID/"
            },
            "date_added": "YYYY-MM-DD HH:II",
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "new": {
                "text": "TEXT"
            },
            "old": {
                "text": "TEXT"
            }
        },
        {
            "action": "update",
            "object": {
                "type": "task",
                "id": "TASK_ID",
                "page": "/project/PROJECT_ID/TASK_ID/"
            },
            "date_added": "YYYY-MM-DD HH:II",
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "new": {
                "date_end": "YYYY-MM-DD"
            },
            "old": {
                "date_end": "YYYY-MM-DD"
            }
        }
    ]
}