Ознакомьтесь с информацией в справочных центрах по API Notiondesk

API Notiondesk позволяет получить список всех центров поддержки в вашем рабочем пространстве, прочитать конфигурацию каждого центра поддержки и проверить статус его запланированной синхронизации с Notion. Начните здесь: центр поддержки id, возвращаемый этими маршрутами, — это site_id, который принимает каждый другой маршрут API Notiondesk.

В API Notiondesk справочный центр называется сайтом .

Перечислите ваши центры помощи.

В список включены все центры поддержки в рабочей области, которым принадлежит ваш ключ, начиная с самых старых, с использованием постраничной навигации с параметрами page_size и cursor.

curl "https://api.notiondesk.so/sites?page_size=50" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "object": "list",
  "data": [
    {
      "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
      "full_domain": "help.example.com",
      "enabled": true,
      "default_locale": "en",
      "locales": ["en", "fr"]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

У вас несколько центров поддержки? См. раздел «Создание нескольких центров поддержки» .

Ознакомьтесь с настройками справочного центра.

В ответе описывается справочный центр и все настройки, которые может изменить API. Прочитайте его еще раз после обновления настроек, чтобы подтвердить новое состояние: маршруты настроек отвечают 204 No Content без тела ответа.

curl "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
  "full_domain": "help.example.com",
  "enabled": true,
  "default_locale": "en",
  "access_mode": "public",
  "guest_access_requires_login": true,
  "supported_locales": ["en", "fr"],
  "available_locales": ["en", "fr", "de", "es"],
  "auto_sync_enabled": true,
  "seo_indexing_enabled": true,
  "setting_content_items": [
    {"locale": "en", "page_title": "Example Help Center", "page_description": "Answers about Example"}
  ],
  "auto_translate_enabled": false,
  "auto_translate_source_locale": null,
  "llms_txt_enabled": true,
  "markdown_export_enabled": true,
  "ai_contextual_menu_enabled": false,
  "mcp_search_enabled": true,
  "contact_form_enabled": true,
  "changelog_enabled": true,
  "changelog_email_subscriptions_enabled": false,
  "changelog_reactions_enabled": true,
  "changelog_email_subject_pattern": null,
  "changelog_categories": [
    {"category_id": "2984612035", "color": "blue_sky"}
  ]
}

Проверьте статус запланированной синхронизации.

В ответ отображается тот же статус, что и на панели управления для запланированных синхронизаций:

curl "https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/sync-status" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

{
  "auto_sync_enabled": true,
  "frequency": "daily",
  "next_sync_at": "2026-10-19T06:00:00+00:00",
  "current_status": "idle",
  "recent_runs": [
    {
      "started_at": "2026-10-18T06:00:02+00:00",
      "finished_at": "2026-10-18T06:01:41+00:00",
      "status": "success",
      "message": "Synced successfully.",
      "error_category": null,
      "requires_customer_action": false
    }
  ]
}

Каждый запуск имеет значения started_at, finished_at (null во время выполнения и для запуска, который завершился по истечении времени ожидания), status (in_progress, success или failed), короткое значение message, а для неудачного запуска:

Если requires_customer_action равно true, то следующий запуск также завершится с ошибкой, пока вы не исправите что-нибудь, например, проблему с подключением к Notion. См. раздел «Как синхронизировать ваш справочный центр с Notion» .

В статусе синхронизации отображаются только запланированные запуски. Синхронизация, запущенная через API или панель управления, не отображается в списке. См. раздел «Запуск синхронизации Notion с помощью API Notiondesk», чтобы подтвердить запуск синхронизации.recent_runs

Ошибки

Каждый маршрут также может отвечать на запросы invalid_version, authentication_error, rate_limited и internal_error. См. раздел «Обработка ошибок API Notiondesk, ограничений скорости и повторных попыток» .

Часто задаваемые вопросы

Что дальше?

• Читайте статьи, подборки и записи об изменениях с помощью API Notiondesk

• Trigger Notion синхронизируется с API Notiondesk

• Обновите настройки справочного центра с помощью API Notiondesk