Перейти к документации
База знаний

Календари по CalDAV

Синхронизируйте календарь адреса с Apple Calendar, Thunderbird, DAVx5 на Android и любым другим приложением с поддержкой CalDAV, входя с паролем приложения.

Настройки

Календарное приложение входит с теми же именем пользователя и паролем приложения, что и почтовое, и получает доступ к календарю только этого адреса.

НастройкаЗначение
Серверapi.openemail.uk, порт 443, HTTPS
Полный адресhttps://api.openemail.uk/dav/, для приложений, которые запрашивают URL
Имя пользователяАдрес целиком, например [email protected]
ПарольПароль приложения для этого адреса, такой же, какой использует почтовое приложение
  • Остальное календарные приложения находят сами: /.well-known/caldav перенаправляет их на /dav/, а оттуда к календарям адреса.
  • Чтобы видеть календарь, нужно разрешение читать его, а чтобы менять события, нужно разрешение менять календарь.
  • Пароль, созданный по ссылке для настройки, открывает и почту, и календарь, но никогда не контакты.
  • Календарь можно выключить для отдельного адреса с помощью его переключателя CalDAV в подразделе «Серверы» на вкладке «Почтовые приложения».
  • Контакты синхронизируются так же, по CardDAV, с тем же сервером, именем пользователя и паролем.

Календарь на iPhone и iPad

  1. Откройте «Настройки», затем «Приложения», затем «Календарь», затем «Учетные записи календаря».
  2. Коснитесь «Новая учетная запись», затем «Другое», затем «Учетная запись CalDAV».
  3. Введите api.openemail.uk в поле «Сервер», адрес целиком в поле «Имя пользователя», пароль приложения в поле «Пароль» и описание в поле «Описание», например «Работа». Коснитесь «Далее».
  4. Оставьте «Календари» включёнными, выключите «Напоминания» и коснитесь «Сохранить».
  • Профиль с вкладки «Почтовые приложения» настраивает календарь и приложение «Почта» вместе, за один шаг.
  • OpenEmail хранит только события, поэтому напоминания остаются на устройстве.

Календарь на Mac

  1. Откройте приложение «Календарь» и выберите «Календарь», затем «Добавить учетную запись».
  2. Выберите «Другая учетная запись CalDAV», затем «Продолжить».
  3. Для параметра «Тип учетной записи» выберите «Вручную», укажите адрес целиком в поле «Имя пользователя», пароль приложения в поле «Пароль» и api.openemail.uk в поле «Адрес сервера», затем выберите «Войти».

Если в режиме «Вручную» календарь не находится, выберите вместо этого «Дополнительно» и укажите «Адрес сервера» api.openemail.uk, «Server Path» /dav/, «Порт» 443 и включите «Использовать SSL».

Thunderbird

  1. Откройте вкладку «Календарь» и выберите «Новый календарь».
  2. Выберите «В сети», затем «Далее».
  3. Укажите адрес целиком в поле «Имя пользователя» и https://api.openemail.uk/dav/ в поле «Location», затем выберите «Find Calendars».
  4. Когда появится запрос, войдите с паролем приложения. Thunderbird покажет список календарей адреса. Отметьте нужные и выберите «Подписаться».

Android с помощью DAVx5

  1. Установите DAVx5 из Google Play или F-Droid и откройте его.
  2. Коснитесь кнопки с плюсом и выберите «Вход по URL и имени пользователя».
  3. Укажите https://api.openemail.uk/dav/ в поле «Базовый URL», адрес целиком в поле «Имя пользователя» и пароль приложения в поле «Пароль», затем коснитесь «Login».
  4. Оставьте в качестве имени аккаунта адрес целиком, который DAVx5 использует как организатора создаваемых вами событий, и коснитесь «Create account».
  5. Откройте вкладку CalDAV нового аккаунта и отметьте календари для синхронизации. После этого они появятся в Google Calendar и во всех других календарных приложениях на телефоне.

DAVx5 синхронизирует данные с интервалом, заданным в настройках аккаунта, а кнопка синхронизации запускает её сразу.

Что видит календарное приложение

  • Календарное приложение, вошедшее под адресом, видит события, которые этот адрес организует или на которые он приглашён, а также события, созданные вами самими. Ваши подписки показываются рядом с ними как календари только для чтения.
  • В приложении календарь называется OpenEmail. Каждая подписка сохраняет данное вами название, а если переименовать подписку в приложении, она переименуется и в OpenEmail.
  • Синхронизируются события в диапазоне примерно от трёх лет назад до десяти лет вперёд. Более ранние и более поздние остаются в OpenEmail.
  • Событие может занимать до 1 МБ. Задачи и напоминания не сохраняются.
  • Приложения, которые проверяют, когда люди свободны, могут видеть, когда заняты другие адреса рабочего пространства, на период до 120 дней за раз.
Для приложений, которые спрашиваютПуть
Обнаружение/.well-known/caldav, который перенаправляет на /dav/
Принципал/dav/principals/{principal}/, где {principal} это id адреса
Каталог календарей/dav/calendars/{principal}/
События/dav/calendars/{principal}/events/
Подписки/dav/calendars/{principal}/sub- и id каждой подписки, только для чтения

Приглашения и ответы

  • Приглашая людей из календарного приложения, вы отправляете настоящие приглашения с этого адреса, а ответ на приглашение там уходит организатору, как и при нажатии кнопок в OpenEmail. Для изменения событий нужно разрешение менять календарь, а для отправки приглашений нужно разрешение отправлять с этого адреса.
  • Если изменить время, место или подробности события, которое вы организовали, гости получат обновление, а если удалить гостя, ему будет отправлена отмена приглашения.
  • Если удалить организованное вами событие с гостями, оно отменится для всех гостей. Если удалить полученное приглашение, оно будет отклонено.

Google Calendar и Outlook

Google Calendar и Outlook.com не могут входить на сторонний календарный сервер, поэтому дайте им вместо этого ссылку на календарь.

Если что-то не работает

  • Приложение постоянно запрашивает пароль: имя пользователя должно содержать адрес целиком, а паролем должен быть пароль приложения для этого адреса. На такой вход OpenEmail отвечает сообщением «Sign in with your email address and an app password from OpenEmail».
  • Приложение входит, но не находит календарь: проверьте, что указан сервер api.openemail.uk, а не домен адреса, или введите полный адрес https://api.openemail.uk/dav/.
  • «This kind of connection is turned off for this address»: у адреса выключен переключатель CalDAV. Попросите владельца рабочего пространства или того, кто управляет доменами, включить его.
  • События нельзя изменить: человеку, которому принадлежит пароль, разрешено только читать календарь, или событие относится к подписке.
  • После отзыва пароля приложения календарное приложение отключается примерно в течение пяти минут.