Интеграционный слой
API и данные
Короткая справка по данным, структуре ответов и рабочим точкам доступа для редакционной, аналитической и технической интеграции.
Живые разделы и входы в данные
Что доступно
Полные карточки документов со спикером, датой, типом, языковыми версиями и тегами.
Атомизированные цитаты и тезисы с привязкой к документу, тематическому блоку и тегам.
Источники, теги, тематические блоки, хронология и агрегированная статистика корпуса.
Быстрые ссылки
Интерактивная документация FastAPI для технической команды и интеграторов.
Полная машиночитаемая схема API для генерации клиентов и интеграции в сервисы.
Машиночитаемая сводка по свежести корпуса, последним документам и доступности Janus-корпуса.
Основные эндпоинты
/api/documents— список документов с фильтрами по спикеру, году, тегу и поисковому запросу/api/documents/{id}— детальная карточка документа/api/atoms— тезисы с фильтрами по блоку, тегу, периоду и спикеру/api/timeline— хронология опубликованных документов с фильтрами по году, категории и спикеру/api/tags,/api/theme-blocks,/api/sources— справочники/api/stats— агрегированная статистика по корпусу/status.json— публичный статус корпуса: свежесть, последние документы и состояние Janus-поиска
Ключевые поля
speaker — корпус спикера, source_type — тип документа, theme_block_code — тематический блок A–G, tags — теги для тематической навигации, is_key_quote — признак опорного тезиса, event_date — дата публикации или выступления.
Допустимые значения speaker: TOKAEV, KARIN, ASHIMBAYEV.
Для удобства также принимаются распространённые алиасы: tokayev, president,
prezident, karin, ashimbaev, ashimbayev.
Происхождение данных и границы API
Публичный API отражает текущий опубликованный срез трёх корпусов: Президента, Государственного советника и Председателя Сената. В ответы попадают только документы и тезисы, прошедшие рабочую публикацию в Qaz.Vision. Дополнительная разметка, языковые версии и уточнение тезисов могут появляться позже без смены идентичности документа.
API не следует трактовать как универсальный архив всех медийных упоминаний или внешних интерпретаций. Отсутствие материала в публичном срезе не означает отсутствие события или позиции вне текущего подтвержденного корпуса.
Форматы выдачи
Для просмотра в браузере используйте pretty JSON. Для выгрузки в файл используйте скачивание JSON.