Семейство: sources

norm_sources_refresh

Запустить синхронизацию источников сейчас, перед ответом на свежих данных. Асинхронно: started означает «запущено», не «готово» — повторите запрос данных через некоторое время. not_configured — обновление по запросу у этой компании не настроено, данные обновляются по расписанию. Реализация вправе разрешать вызов только привилегированным ролям и отвечать отказом unauthorized_scope.

Доступ: запись · Списковый: нет · Версии: 1

Вход

Поле	Обязательно	Тип	Значение

Данные ответа

Поле	При успехе	Тип	Значение
note	нет	string
status	да	started | not_configured

Пример: успешный ответ

{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "sources:refresh",
      "label": "Обновление контекста"
    }
  ],
  "freshness": {
    "as_of": "2026-09-21T09:33:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "status": "started",
    "note": "Синхронизация запущена. Свежие данные появятся через несколько секунд — повторите запрос."
  }
}

norm_sources_status

Какие системы компании подключены, что они питают и когда синхронизировались в последний раз. Состояние demo означает демонстрационные данные: отвечая по такому источнику, предупреждайте пользователя.

Доступ: чтение · Списковый: нет · Версии: 1

Вход

Поле	Обязательно	Тип	Значение

Данные ответа

Поле	При успехе	Тип	Значение
sources	да	список SourceStatus

Пример: успешный ответ

{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "sources:status",
      "label": "Подключённые системы"
    }
  ],
  "freshness": {
    "as_of": "2026-09-21T06:00:00.000Z",
    "ttl_sec": 86400,
    "stale": false
  },
  "data": {
    "sources": [
      {
        "id": "crm",
        "name": "Система продаж",
        "kind": "CRM",
        "status": "connected",
        "last_synced_at": "2026-09-21T06:00:00+03:00",
        "feeds": [
          "сделки",
          "контакты"
        ]
      },
      {
        "id": "kb",
        "name": "База знаний",
        "kind": "документы",
        "status": "connected",
        "last_synced_at": "2026-09-21T03:00:00+03:00",
        "feeds": [
          "поиск",
          "протоколы"
        ]
      },
      {
        "id": "accounting",
        "name": "Учётная система",
        "kind": "учёт",
        "status": "planned",
        "feeds": []
      },
      {
        "id": "compliance",
        "name": "Отчёт по регламенту",
        "kind": "операционный контроль",
        "status": "demo",
        "last_synced_at": "2026-06-17T06:00:00+03:00",
        "feeds": [
          "показатели"
        ]
      }
    ]
  }
}