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

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

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

Функция ПолучитьСобытияКалендарей(Знач 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/av5...";
    IDВладельца = 1;
    Тип         = "user";

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

    URL          = "b24-ar17wx.bitrix24.by";
    Токен        = "a5b00469006e9f06006b12e400000001000...";
    IDСобытия    = "3046";
    IDКалендаря1 = "1648";
    IDКалендаря2 = "1650";

    Завтра      = 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':'05/27/2026 17:58:06','to':'05/28/2026 17:58:06','section':['2498','2500']}" \
      --token "***"
Результат
{
 "result": [
  {
   "ID": "4728",
   "PARENT_ID": "4728",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "Новое событие",
   "DATE_FROM": "27.05.2026 17:58:00",
   "DATE_TO": "27.05.2026 18:58:00",
   "ORIGINAL_DATE_FROM": "***",
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1779883077",
   "DATE_TO_TS_UTC": "1782489480",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "26.05.2026 20:57:57",
   "TIMESTAMP_X": "26.05.2026 20:57:57",
   "DESCRIPTION": "Описание события",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "1",
   "ACCESSIBILITY": "quest",
   "IMPORTANCE": "normal",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "NOTIFY": true,
    "REINVITE": "***",
    "ALLOW_INVITE": "***",
    "HIDE_GUESTS": true,
    "MEETING_CREATOR": 1,
    "LANGUAGE_ID": "ru",
    "MAIL_FROM": false
   },
   "LOCATION": "Офис",
   "REMIND": [
    {
     "type": "day",
     "count": 1
    }
   ],
   "COLOR": "#230000",
   "TEXT_COLOR": "",
   "RRULE": {
    "FREQ": "DAILY",
    "COUNT": 3,
    "INTERVAL": 10,
    "UNTIL": "06.06.2026",
    "~UNTIL": "06.06.2026",
    "UNTIL_TS": 1780704000
   },
   "EXDATE": "",
   "DAV_XML_ID": "20260527T145800Z-517953d95071cd9f9ced8fc0c88add6d@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": "2498",
   "SYNC_STATUS": null,
   "UF_CRM_CAL_EVENT": null,
   "UF_WEBDAV_CAL_EVENT": null,
   "SECTION_DAV_XML_ID": null,
   "DATE_FROM_FORMATTED": "Wed May 27 2026 17:58:00",
   "DATE_TO_FORMATTED": "Wed May 27 2026 18:58:00",
   "IS_DAYLIGHT_SAVING_TZ": "N",
   "SECT_ID": "2498",
   "OPTIONS": null,
   "ATTENDEE_LIST": [
    {
     "id": 1,
     "entryId": "4728",
     "status": "H"
    },
    {
     "id": 10,
     "entryId": "4730",
     "status": "Q"
    }
   ],
   "COLLAB_ID": null,
   "~RRULE_DESCRIPTION": "каждый 10-й день, от 27.05.2026 до 06.06.2026",
   "attendeesEntityList": [
    {
     "entityId": "user",
     "id": 1
    },
    {
     "entityId": "user",
     "id": 10
    }
   ],
   "~DATE_FROM": "27.05.2026 17:58:00",
   "~DATE_TO": "27.05.2026 18:58:00",
   "RINDEX": 0,
   "~USER_OFFSET_FROM": 0,
   "~USER_OFFSET_TO": 0
  },
  {
   "ID": "4732",
   "PARENT_ID": "4732",
   "ACTIVE": "Y",
   "DELETED": "N",
   "CAL_TYPE": "user",
   "OWNER_ID": "1",
   "NAME": "Новое событие",
   "DATE_FROM": "27.05.2026 17:58:00",
   "DATE_TO": "27.05.2026 18:58:00",
   "ORIGINAL_DATE_FROM": "***",
   "TZ_FROM": "Europe/Minsk",
   "TZ_TO": "Europe/Minsk",
   "TZ_OFFSET_FROM": "10800",
   "TZ_OFFSET_TO": "10800",
   "DATE_FROM_TS_UTC": "1779883077",
   "DATE_TO_TS_UTC": "1782489480",
   "DT_SKIP_TIME": "N",
   "DT_LENGTH": 3600,
   "EVENT_TYPE": null,
   "CREATED_BY": "1",
   "DATE_CREATE": "26.05.2026 20:57:58",
   "TIMESTAMP_X": "26.05.2026 20:57:58",
   "DESCRIPTION": "Описание события",
   "DT_FROM": null,
   "DT_TO": null,
   "PRIVATE_EVENT": "1",
   "ACCESSIBILITY": "quest",
   "IMPORTANCE": "normal",
   "IS_MEETING": true,
   "MEETING_STATUS": "H",
   "MEETING_HOST": "1",
   "MEETING": {
    "HOST_NAME": "Антон Титовец",
    "NOTIFY": true,
    "REINVITE": "***",
    "ALLOW_INVITE": "***",
...