Calendly

Calendly — интеграция с API Calendly с использованием управляемой OAuth-аутентификации. Позволяет получать доступ к типам событий, запланированным встречам, участникам, данным доступности и управлять вебхуками для автоматизации процессов планирования.

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

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

Пример запроса для получения информации о текущем пользователе:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/calendly/users/me')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/calendly/{native-api-path}

Замените {native-api-path} на фактический путь API Calendly. Шлюз автоматически проксирует запросы к api.calendly.com и подставляет OAuth-токен.

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

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

Authorization: Bearer $MATON_API_KEY

Переменная окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Войдите или зарегистрируйтесь на maton.ai
• Перейдите в раздел настроек
• Скопируйте ваш API-ключ

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

Управление OAuth-подключениями Calendly осуществляется через:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=calendly&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'calendly'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Получение информации о подключении

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Пример ответа:

{
 "connection": {
 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
 "status": "ACTIVE",
 "creation_time": "2025-12-08T07:20:53.488460Z",
 "last_updated_time": "2026-01-31T20:03:32.593153Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "calendly",
 "metadata": {}
 }
}

Откройте возвращённый URL в браузере, чтобы завершить процесс OAuth-авторизации.