Zoho Calendar

Zoho Calendar — это интеграция API Zoho Calendar с поддержкой управляемой OAuth-аутентификации. Решение позволяет полноценно управлять календарями и событиями: создавать, читать, обновлять и удалять записи, работать с повторяющимися событиями и участниками.

Используйте этот инструмент, если вам нужно автоматизировать работу с календарями, управлять расписанием или планировать встречи. Для работы с другими сторонними сервисами рекомендуется использовать API Gateway.

Быстрый старт

Пример запроса для получения списка календарей:

import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-calendar/api/v1/calendars')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Базовый URL API:

https://gateway.maton.ai/zoho-calendar/api/v1/{endpoint}

Шлюз автоматически проксирует запросы к Zoho Calendar API и добавляет OAuth-токен.

Аутентификация

Все запросы требуют API-ключ Maton, передаваемый в заголовке:

Authorization: Bearer $MATON_API_KEY

Перед началом работы установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получить ключ можно в настройках аккаунта на maton.ai.

Управление подключениями

Подключения OAuth для Zoho Calendar управляются через сервис ctrl.maton.ai.

Получение списка подключений:

GET https://ctrl.maton.ai/connections?app=zoho-calendar&status=ACTIVE

Создание подключения:

POST https://ctrl.maton.ai/connections

После создания откройте полученный URL в браузере для завершения OAuth-авторизации.

Удаление подключения:

DELETE https://ctrl.maton.ai/connections/{connection_id}

Если у вас несколько подключений, можно указать нужное через заголовок:

Maton-Connection: 

Работа с календарями

Получить список календарей:

GET /zoho-calendar/api/v1/calendars

Создать календарь:

POST /zoho-calendar/api/v1/calendars?calendarData={json}

Обязательные параметры:

• name — название календаря (до 50 символов)
• color — цвет в HEX-формате

Дополнительные параметры включают описание, часовой пояс, видимость и настройки занятости.

Удалить календарь:

DELETE /zoho-calendar/api/v1/calendars/{calendar_uid}

Работа с событиями

События позволяют управлять встречами, участниками и временными интервалами. Вы можете получать список событий, создавать новые встречи и обновлять существующие.

Пример получения событий:

GET /zoho-calendar/api/v1/calendars/{calendar_uid}/events

Поддерживаются параметры диапазона дат, повторяющиеся события и управление участниками.

Итог

Интеграция Zoho Calendar предоставляет полный набор инструментов для работы с расписанием через API. Благодаря OAuth-аутентификации и прокси-шлюзу можно безопасно управлять календарями и событиями, автоматизируя процессы планирования и взаимодействия с пользователями.