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