Обновление интеграции Notion API до актуальной модели данных
Обновление интеграции Notion API требуется, когда программа обращается к базе как к одной таблице, а современная модель Notion разделяет database-контейнер и находящиеся внутри него data sources — источники данных. С версии 2025-09-03 операции со схемой, запросами и записями таблицы переехали в семейство /v1/data_sources.
В актуальной версии 2026-03-11 дополнительно изменились позиционирование новых блоков, поле состояния корзины и название блока заметок встречи. Мы разбираем действующий обмен, сохраняем привычную бизнес-логику и переводим технические вызовы на новую модель. В результате заявки, задачи, контент или отчёты снова попадают в нужную таблицу, связи между записями сохраняются, а ошибки API видны в журнале с понятной причиной.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Интеграция хранит database_id и обращается к старым методам чтения, изменения или запроса базы.
- После появления дополнительного data source программа получает validation_error, записывает страницу в соседнюю таблицу или перестаёт видеть свойства.
- Команда хочет перейти на Notion-Version 2026-03-11 и заранее проверить все несовместимые изменения.
- Сайт, CRM или автоматизация регулярно создают задачи в Notion, поэтому остановка обмена сразу влияет на работу сотрудников.
Что именно мы сделаем
Инвентаризируем обращения к Notion, используемую версию API, библиотеку и все идентификаторы баз.
Определяем database-контейнеры и соответствующие data source для каждого рабочего сценария.
Обновляем запросы, структуры ответов, связи, пагинацию и используемые операции с блоками.
Проверяем обмен на копии данных и выпускаем изменения с контролируемым переключением.
Передаём карту интеграции, журнал контрольных сценариев и инструкцию для дальнейшей поддержки.
Что входит в стоимость
59 900 ₽ за всю работу
Проверяем действующий код и реальные сценарии обмена, составляем карту старых вызовов, переводим операции с таблицами на /v1/data_sources, обновляем заголовок Notion-Version и совместимую клиентскую библиотеку, исправляем обработку идентификаторов, полей и связей. Затем прогоняем чтение, создание, изменение, поиск, пагинацию и используемые операции с блоками на тестовых данных, включаем журнал ошибок и выпускаем обновление с понятным планом возврата.
Что будет готово
Передадим вам
- Обновлённая интеграция Notion API с актуальной моделью database и data source.
- Карта методов, идентификаторов, свойств и связей, используемых рабочими сценариями.
- Журнал контрольных проверок чтения, создания, изменения, поиска, связей и блоков.
- Инструкция по настройке доступа, замене идентификаторов и безопасному выпуску следующих изменений.
Перед сдачей проверим
- Интеграция обнаруживает выбранный data source внутри database и читает его актуальную схему.
- Контрольная запись создаётся в нужном источнике, получает выбранные свойства и обновляется повторным запросом.
- Связь с другой таблицей сохраняется по правильному data_source_id и открывается в Notion с ожидаемой записью.
- Используемые операции с блоками и корзиной проходят на Notion-Version 2026-03-11, а сбой фиксируется в журнале вместе с методом и объектом.
Как это выглядит на практике
Заявка с сайта попадает в нужный источник данных Notion
- 01
Форма передаёт имя, контакт, текст задачи и метку источника во внутренний обработчик.
- 02
Обработчик находит настроенный data source «Заявки», проверяет доступные свойства и создаёт страницу с родителем data_source_id.
- 03
Следующий вызов добавляет описание в конец страницы через position и связывает заявку с записью клиента.
- 04
Тест читает созданную страницу обратно, сверяет поля и сохраняет идентификатор в журнале обмена.
Что понадобится для работы
От вас
- Доступ к исходному коду или настройкам автоматизации, где выполняются запросы к Notion.
- Тестовая connection Notion с доступом к выбранным страницам, database и data sources.
- Перечень рабочих сценариев, обязательных свойств, связей и ожидаемых статусов.
- Безопасный пример данных для проверки создания, обновления, поиска и обработки ошибки.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 56 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Какая версия Notion API считается актуальной?
На дату подготовки страницы актуальная версия — 2026-03-11. Её задают обязательным заголовком Notion-Version либо параметром клиента SDK. Перед выпуском мы повторно сверяем версию и официальный журнал изменений.
Чем database отличается от data source?
Database стал контейнером, который может содержать один или несколько data sources. Конкретный data source хранит схему таблицы и записи, поэтому запросы, создание страниц и связи должны использовать его идентификатор.
Почему старая интеграция могла работать до появления второй таблицы?
Старая модель предполагала один набор свойств у database. Когда контейнер получает несколько источников данных, прежний database_id перестаёт однозначно определять конкретную таблицу, и отдельные операции завершаются ошибкой либо требуют data_source_id.
Какие изменения версии 2026-03-11 проверяются?
Проверяем замену after на объект position при добавлении блоков, переход с archived на in_trash и переименование transcription в meeting_notes. В проект входят только реально используемые операции, а карта кода показывает каждое найденное место.
Потребуется заново выдавать доступ интеграции?
Существующая connection обычно сохраняет токен. Мы проверяем, что ей открыты нужные страницы и новые data sources. Если сотрудник создал источник в другом разделе пространства, владелец доступа добавляет его к connection в интерфейсе Notion.
Сохранятся ли текущие связи и свойства?
Да. Перед изменением составляем таблицу соответствий свойств и relation, затем прогоняем чтение на существующих данных и создаём отдельные контрольные записи. Перенос содержимого самой таблицы требуется лишь при отдельной задаче на изменение структуры.
Как обрабатываются ограничения и временные ошибки API?
Клиент различает ошибку доступа, проверку данных, ограничение частоты и временный сбой. Для повторяемых операций добавляем управляемые повторы, а журнал сохраняет метод, объект и понятное сообщение для ответственного сотрудника.
Как принимается готовая работа?
Вместе выполняем контрольные сценарии чтения, создания, изменения, связи, поиска и используемых блоков. Результаты сверяются в Notion и в журнале интеграции, после чего передаём карту идентификаторов и инструкцию поддержки.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Инвентаризация Shadow API и старых методов
Найти старые методы и скрытые вызовы Notion API
- 02Обновление интеграции Notion API до актуальной модели данных
Перевести интеграцию на актуальную модель data sources
- 03Контрактные тесты API по OpenAPI
Закрепить формат запросов контрактными тестами API