Питання і відповіді - що таке Отримання історії подій за період часу через 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"
            }
        }
    ]
}