Корпус Токаева

ОТКРЫТЫЕ ДАННЫЕ · V1

Интеграции и открытые данные

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

Две ссылки – разные задачи. primary_source_url ведёт к первичному документу; qazvision_url – к карточке записи в корпусе.

СЦЕНАРИИ

Четыре сценария работы

Одну запись можно показать читателю, передать в редакционную систему, использовать в исследовании или подключить к внешнему приложению.

1

Публичная страница

Чтение

Карточка с цитатой, сведениями о публикации и первоисточником.

2

Редакция

Публикация

Лента для сайта, текстовый блок, вставка и подборки.

3

Исследования

Анализ

Происхождение данных, изменения, каналы и экспорт.

4

Разработчик

Подключение

Описание методов, JSON, CORS и постоянные URL.

ТЕХНИЧЕСКОЕ ПОДКЛЮЧЕНИЕ

Готовые форматы подключения

Для разработчиков и технических специалистов. Точки доступа не изменяют данные.

Вставка на сайт

<iframe src="https://gg.qdev.run/embed/gg_qazvision_atom_16242.html" loading="lazy" title="Высказывание Токаева"></iframe>
Открыть блок →

ХРОНОЛОГИЯ

Корпус по годам

Загружаем годовые счётчики…

Открыть JSON-слой →

ТОЧКИ ДОСТУПА

Маршруты и методы

GET /api/v1/quotes.json

Полный опубликованный набор карточек. Разрешён CORS для публичного чтения.

GET /api/v1/records/{id}.json

Одна карточка для сайта: цитата, сведения о публикации, первоисточник, качество фрагмента и двойной указатель TextPositionSelector/TextQuoteSelector.

GET /records/{id}.html

Отдельная страница записи для ссылки в статье, исследовании и справочном материале.

GET /embed/{id}.html

Переносимый HTML-блок для вставки на страницы СМИ и спецпроектов. Рабочий пример доступен по ссылке.

GET /api/v1/changes.json

Лента изменений для отслеживания публикаций и мониторинга.

GET /api/v1/changes.ndjson

Построчная incremental-лента событий публикации для внешней синхронизации.

GET /api/v1/integration.json

Манифест bootstrap/incremental-подключения: форматы, границы чтения и обязательные проверки.

GET /api/v1/codebook.json

Справочник типов доказательств: прямая речь, атрибутированное высказывание, пересказ позиции и редакционный факт.

GET /api/v1/channels.json

Машиночитаемый список тематических каналов из опубликованных записей.

GET /api/v1/channels/{id}.json

Лента выбранной темы с полями для сайта, текстовым блоком, вставкой и прямыми ссылками на первоисточники.

GET /api/v1/audiences.json

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

GET /api/v1/source-lineage.json

Поставщик данных, фильтры импорта и правила публикации – для проверки происхождения.

GET /api/v1/coverage.json

Покрытие корпуса: цитаты, документы, темы и типы событий с воспроизводимыми счётчиками.

GET /api/v1/avds.json

Версионированный consumer-контракт AV DS: тема, aliases, route families и responsive-матрица GG.

GET /api/v1/facets.json

Компактные фасеты для навигации и аналитики: тип материала, тема, год, издатель и документы с/без цитат.

GET /api/v1/timeline.json

Годовые счётчики записей и документов, включая долю документов без отдельной прямой цитаты; подходит для лёгких графиков и подборок.

GET /api/v1/corpus-audit.json

Свежесть snapshot, дубли, locator/topic/source review и доказательные счётчики корпуса.

GET /api/v1/review-queue.json

Read-only очередь записей, которым нужна дополнительная редакционная сверка.

GET /api/search

Серверный полнотекстовый поиск с фильтрами, пагинацией, ETag и двумя слоями результата.

GET /api/search/export

HTML, JSON, CSV или Markdown-выгрузка текущего отбора с фильтрами, scope и первоисточниками; HTML подходит для печати.

GET /api/search/dossier

Открываемое HTML-досье текущего отбора: snapshot, release, фильтры, counts, locator-статус и ссылки на карточки GG и первоисточники.

GET /api/search/compare

Сравнение опубликованных формулировок по двум периодам или темам с release identity, карточками GG и первоисточниками.

GET /api/search/compare/export

Сравнение в HTML, JSON, CSV или Markdown; выгрузка сохраняет snapshot, ограничения и доказательные ссылки.

GET /api/v1/documents.json

Полный слой 2 091 документов Токаева, включая документы без отдельной прямой цитаты.

GET /api/v1/documents/{id}.json

Одна карточка документа с официальным первоисточником, числом цитат и устойчивой ссылкой.

GET /api/v1/sources.json

Книги, диссертация и персональные научные публикации с библиографией, ссылкой на текст и статусом доступа.

GET /api/v1/sources/{id}.json

Одна карточка источника для цитат, поиска и внешних исследовательских систем.

POST /api/assistant/ask

Ответ ассистента на вопрос по опубликованному корпусу со ссылками на найденные источники. Отправляйте вопрос; ответ не заменяет первичный документ. Открыть ассистента →

GET /api/v1/openapi.json

Минимальное описание методов для сайтов, ботов, обработки данных и редакционных систем.

GET /feeds/cms/latest.json

Единый объект для редакционной системы: цитата, редакционное резюме, постоянная ссылка, источник, текстовый блок и HTML-вставка.

GET /feeds/cms/latest.ndjson

Построчная лента для обработки данных, редакционных ботов и аналитических систем.

GET /feeds/cms/latest.md

Текстовый пакет для редакторов, авторов и объяснительных материалов.

GET /kit/corpus-brief.pdf

Готовая краткая справка корпуса для редакционного, исследовательского или служебного брифинга.

GET /kit/chronology.pdf

Полная PDF-хронология документов корпуса с датами, темами, числом цитат и первоисточниками.

GET /data/records.json

Канонический реестр, из которого строятся открытые данные, подписка и статус публикации.

GET /rss.xml

Лента изменений с устойчивой ссылкой на запись корпуса и сохранённым первичным источником.

GET /health.json

Показывает готовность публикации, версию схемы и число записей.

ПРАВИЛА

Как использовать данные

  1. Сохраняйте первоисточник. При цитировании передавайте primary_source_url, дату, сведения о публикации и идентификатор.
  2. Различайте ссылки. qazvision_url ведёт на карточку корпуса, а primary_source_url – на первичный документ.
  3. Не меняйте смысл. quote – точная цитата; editorial_summary и legacy-поле context содержат редакционную аннотацию, а не фрагмент источника.
  4. Проверяйте происхождение. source показывает поставщика и количество импортированных записей.