Коннектор Notion

Коннектор Notion — один из самых универсальных коннекторов, поддерживающий три режима синхронизации: поиск по всему рабочему пространству, запрос к базе данных и обход дерева родительских страниц.

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

OAuth — требуются области:

• read:content
• read:database

Конфигурация

Режимы синхронизации

Рабочее пространство

Ищет все страницы в рабочем пространстве. Лучше всего подходит для комплексной синхронизации.

База данных

Запрашивает конкретную базу данных Notion. Каждая строка базы данных становится документом.

Родительская страница

Синхронизирует все дочерние страницы под указанной страницей. Использует рекурсивный обход блоков.

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

1. Выбор режима — разные эндпоинты API в зависимости от режима: поиск, запрос к базе данных или дочерние блоки
2. Получение блоков — рекурсивно загружает все блоки для каждой страницы
3. Преобразование Rich Text — преобразует форматированный текст Notion в обычный текст
4. Обработка типов блоков — поддерживает абзацы, заголовки, блоки кода, уравнения, списки задач и многое другое
5. Отложенный контент — заглушки при листинге; полный контент блоков загружается через getDocument

Формат документа

Страницы преобразуются из блоков Notion:

Заголовок страницы

Текст абзаца...

# Заголовок 1
Абзац...

## Заголовок 2
Ещё текст...

```python
блок кода

• Выполненная задача
• Ожидающая задача

## Теги метаданных

| Тег | Тип | Описание |
|-----|------|-------------|
| Теги | Text | Теги/свойства страницы Notion |
| Последнее изменение | Date | Время последнего редактирования |
| Создано | Date | Время создания |