Outlook

Outlook

Получите доступ к API Microsoft Outlook (через Microsoft Graph) с управляемой OAuth-аутентификацией. Читайте, отправляйте и управляйте электронными письмами, папками, событиями календаря и контактами.

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

# Получить профиль пользователя
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/outlook/v1.0/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/outlook/{native-api-path}

Замените {native-api-path} на соответствующий путь конечной точки Microsoft Graph API. Шлюз проксирует запросы к graph.microsoft.com и автоматически добавляет ваш OAuth-токен.

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

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

Authorization: Bearer $MATON_API_KEY

Переменная окружения: задайте API-ключ следующим образом:

export MATON_API_KEY="YOUR_API_KEY"

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

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

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

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

https://ctrl.maton.ai

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

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=outlook&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': 'outlook'}).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": "outlook",
 "metadata": {}
 }
}

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

Обработка ошибок

• 400 — отсутствует подключение Outlook
• 401 — неверный или отсутствующий API-ключ
• 429 — превышен лимит запросов (10 запросов в секунду на аккаунт)
• 4xx/5xx — ошибки, возвращаемые Microsoft Graph API

Устранение неполадок

Проблемы с API-ключом

• Проверьте, что переменная окружения MATON_API_KEY установлена
• Убедитесь в корректности ключа, выполнив запрос списка подключений

Некорректное имя приложения

Убедитесь, что путь URL начинается с outlook.

• Корректно: https://gateway.maton.ai/outlook/v1.0/me/messages
• Некорректно: https://gateway.maton.ai/v1.0/me/messages

Ресурсы

• Обзор Microsoft Graph API
• Mail API
• Calendar API
• Contacts API
• Параметры запросов