Все ноды/Integrations/Calendar

Список календарей

Список коллекций календарей для подключённого аккаунта CalDAV.

Как попробовать

Как применять

Разведочная нода: показывает, какие коллекции календарей есть у аккаунта, и главное — их URL, которые дальше подставляются во все остальные календарные ноды. Держать её в рабочем графе обычно незачем: адрес коллекции стабилен, его достаточно посмотреть один раз и вписать в поля или в «URL календаря по умолчанию» самой интеграции.

Как это работает

Нода находит домашний каталог календарей аккаунта и перечисляет коллекции в нём. Собственных настроек, кроме подключения, у неё нет — всё решает режим обнаружения, заданный в интеграции CalDAV.

В режиме «Автоматически» нода спрашивает у сервера, кому принадлежат учётные данные, и где лежат его календари, при неудаче пробуя стандартный адрес .well-known/caldav. Если в подключении выбрано «Указать URL календаря вручную», нода вообще не ходит за списком: она возвращает ровно один элемент — этот самый URL, с пустым названием.

На выходе calendars: у каждой записи href, display_name и color (может быть null).

Частые ошибки

• Один элемент вместо всех. Это не пустой аккаунт, а режим «Указать URL календаря вручную» в интеграции. Переключите его на «Автоматически», если нужен полный список.
• Пустое display_name. Название — необязательное свойство коллекции; ориентируйтесь на href, а не на подпись.
• «Could not discover current-user-principal». Код PROVIDER_ERROR с таким текстом почти всегда означает неверный базовый URL подключения. Лечится либо исправлением адреса, либо режимом «Указать календарь-хоум вручную» с заполненным URL домашнего календаря.
• Список обрезается на 500 коллекциях. Для обычного аккаунта потолок недостижим, но знать о нём стоит.
• Вызов на каждом ходу чата. Обнаружение — это два-три запроса к серверу ради ответа, который почти никогда не меняется. Лучше один раз записать URL в конфигурацию.

Входы

Выходы

Настройки