🏠 Главная › user guide › productivity notion

{/ Эта страница автоматически передается из навыков SKILL.md с помощью сайта/scripts/generate-skill-docs.py. Редактируйте исходный SKILL.md, а не эту страницу. /}

Понятие

Понятие API через Curl: страницы, базы данных, блоки, поиск.

Метаданные навыки
Источник Встроенный (установлен по умолчанию)
Путь навыки/производительность/представление
Версия 1.0.0
Автор сообщество
Лицензия Массачусетский технологический институт
Платформы Linux, MacOS, Windows
Теги Понятие, Производительность, Заметки, База данных, API

Справочник: полный SKILL.md:::информация

Ниже приведено полное описание навыков, которые Hermes загружает при его активации. Это то, что агент видит в качестве инструкций, когда навыки активны.

API понятий

Используйте Notion API через curl для создания, чтения, обновления страниц, баз данных (источников данных) и блоков. Никаких дополнительных инструментов — только Curl и API-ключ Notion.

Предварительные требования

  1. Создать интеграцию на https://notion.so/my-integrations.
  2. Скопируйте API-ключ (начинается с ntn_ или secret_)
  3. Сохраните его в ~/.hermes/.env: NOTION_API_KEY=ntn_your_key_here
  4. Важно: Предоставьте доступ целевым страницам/базам данных для вашей интеграции в Notion (нажмите "..." → "Подключить к" → название вашей интеграции)

Основы API

Все запросы используют этот шаблон:

curl -s -X GET "https://api.notion.com/v1/..." \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json"

Заголовок Понятие-Версия обязателен. Этот навык использует 2025-09-03 (последняя версия). В этой версии базы данных называются «источниками данных» (источниками данных) в API.

Часто используемые операции

Поиск

curl -s -X POST "https://api.notion.com/v1/search" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"query": "название страницы"}'

Получить страницу

curl -s "https://api.notion.com/v1/pages/{page_id}" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03"

Получить ограничения страницы (блоки)

curl -s "https://api.notion.com/v1/blocks/{page_id}/children" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03"

Создать страницу в базе данных

curl -s -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"database_id": "xxx"},
    "properties": {
      "Name": {"title": [{"text": {"content": "Новый элемент"}}]},
      "Status": {"select": {"name": "Todo"}}
    }
  }'

Запросить размещение данных

curl -s -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {"property": "Status", "select": {"equals": "Active"}},
    "sorts": [{"property": "Date", "direction": "descending"}]
  }'

Создать базы данных

curl -s -X POST "https://api.notion.com/v1/data_sources" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"page_id": "xxx"},
    "title": [{"text": {"content": "Моя база данных"}}],
    "properties": {
      "Name": {"title": {}},
      "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
      "Date": {"date": {}}
    }
  }'

Обновить свойства страницы

curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"properties": {"Status": {"select": {"name": "Done"}}}}'

Добавить святые места на страницу

curl -s -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
  -H "Authorization: Bearer $NOTION_API_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "children": [
      {"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Привет от Hermes!"}}]}}
    ]
  }'

Типы свойств

Распространённые формы свойства для элементов базы данных:

Ключевые отличия в версии API 03.09.2025

Примечания