Перейти к основному содержимому

Получить события календарей

Получает события календарей с фильтрами или без

Функция ПолучитьСобытияКалендарей(Знач URL, Знач IDВладельца, Знач Тип, Знач Фильтр = "", Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрока✔URL внешнего вебхука или адрес Bitrix24 при использовании токена
IDВладельца--ownerСтрока, Число✔ID владельца календаря
Тип--typeСтрока✔Тип календаря: user, group, company_calendar
Фильтр--filterСтруктура Из КлючИЗначение✖Фильтр событий. См. ПолучитьСтруктуруФильтраСобытийКалендарей
Токен--tokenСтрока✖Токен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24


подсказка

Метод в документации API: calendar.event.get


Пример использования для 1С:Предприятие/OneScript
    URL         = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    IDВладельца = 1;
    Тип         = "user";

    Результат = OPI_Bitrix24.ПолучитьСобытияКалендарей(URL, IDВладельца, Тип);

    URL          = "b24-ar17wx.bitrix24.by";
    Токен        = "8536b467006e9f06006b12e400000001000...";
    IDСобытия    = "490";
    IDКалендаря1 = "362";
    IDКалендаря2 = "364";

    Завтра      = OPI_Инструменты.ПолучитьТекущуюДату() + 86400;
    Послезавтра = Завтра + 86400;

    МассивКалендарей = Новый Массив;
    МассивКалендарей.Добавить(IDКалендаря1);
    МассивКалендарей.Добавить(IDКалендаря2);

    Фильтр = Новый Структура;
    Фильтр.Вставить("from"   , Завтра);
    Фильтр.Вставить("to"     , Послезавтра);
    Фильтр.Вставить("section", МассивКалендарей);

    Результат = OPI_Bitrix24.ПолучитьСобытияКалендарей(URL, IDВладельца, Тип, Фильтр, Токен);
    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 ПолучитьСобытияКалендарей \
      --url "b24-ar17wx.bitrix24.by" \
      --owner 1 \
      --type "user" \
      --filter "{'from':'2025-02-19T12:37:25.9452783Z','to':'2025-02-20T12:37:25.9452783Z','section':[374,376]}" \
      --token "***"
Результат
{
 "result": [
  {
   "ID": "58",
   "PARENT_ID": "58",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "Новое событие",
   "DATE_FROM": "28.01.2025 22:29:00",
   "DATE_TO": "28.01.2025 23:29:00",
   "ORIGINAL_DATE_FROM": null,
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1738081739",
   "DATE_TO_TS_UTC": "1740688140",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "27.01.2025 22:28:59",
   "TIMESTAMP_X": "27.01.2025 22:28:59",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "",
   "ACCESSIBILITY": "busy",
   "IMPORTANCE": "high",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "TEXT": null,
    "OPEN": false,
    "NOTIFY": true,
    "REINVITE": false,
    "MAIL_FROM": false
   },
   "LOCATION": "Офис",
   "REMIND": [
    {
     "type": "day",
     "count": 1
    }
   ],
   "COLOR": "#230000",
   "TEXT_COLOR": "",
   "RRULE": {
    "FREQ": "DAILY",
    "COUNT": 3,
    "INTERVAL": 10,
    "UNTIL": "01.01.2038",
    "~UNTIL": "",
    "UNTIL_TS": 2145916800
   },
   "EXDATE": "",
   "DAV_XML_ID": "20250128T192900Z-165159ccf926f8fd81fef570b48b3c08@b24-ar17wx.bitrix24.by",
   "G_EVENT_ID": "",
   "DAV_EXCH_LABEL": "",
   "CAL_DAV_LABEL": "",
   "VERSION": "1",
   "ATTENDEES_CODES": [
    "U1",
    "U10"
   ],
   "RECURRENCE_ID": null,
   "RELATIONS": "",
   "SECTION_ID": "132",
   "SYNC_STATUS": null,
   "UF_CRM_CAL_EVENT": false,
   "UF_WEBDAV_CAL_EVENT": false,
   "SECTION_DAV_XML_ID": null,
   "DATE_FROM_FORMATTED": "Tue Jan 28 2025 22:29:00",
   "DATE_TO_FORMATTED": "Tue Jan 28 2025 23:29:00",
   "SECT_ID": "132",
   "OPTIONS": null,
   "ATTENDEE_LIST": [
    {
     "id": 1,
     "entryId": "58",
     "status": "H"
    },
    {
     "id": 10,
     "entryId": "60",
     "status": "Q"
    }
   ],
   "COLLAB_ID": null,
   "~RRULE_DESCRIPTION": "каждый 10-й день, от 28.01.2025, 3 раз(а)",
   "attendeesEntityList": [
    {
     "entityId": "user",
     "id": 1
    },
    {
     "entityId": "user",
     "id": 10
    }
   ],
   "~DATE_FROM": "28.01.2025 22:29:00",
   "~DATE_TO": "28.01.2025 23:29:00",
   "RINDEX": 0,
   "~USER_OFFSET_FROM": 0,
   "~USER_OFFSET_TO": 0
  },
  {
   "ID": "62",
   "PARENT_ID": "62",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "Новое событие",
   "DATE_FROM": "28.01.2025 22:29:00",
   "DATE_TO": "28.01.2025 23:29:00",
   "ORIGINAL_DATE_FROM": null,
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1738081739",
   "DATE_TO_TS_UTC": "1740688140",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "27.01.2025 22:28:59",
   "TIMESTAMP_X": "27.01.2025 22:28:59",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "",
   "ACCESSIBILITY": "busy",
   "IMPORTANCE": "high",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "TEXT": null,
    "OPEN": false,
    "NOTIFY": true,
    "REINVITE": false,
    "MAIL_FROM": false
   },
   "LOCATION": "Офис",
   "REMIND": [
...