Справочник API

Версионированный публичный API данных только для чтения

Конечные точки цитирования и поиска для метаданных публичной политики. Каждая JSON-конечная точка версионируется в рамках /api/public/v1.

Что возвращает API

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

Что API не делает

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

Рекомендуемое извлечение

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

Роль агентов и API

Рекомендуемое использование для агентов и инструментов обработки данных.

  • Используется для сводок на основе источников, публичного JSON, метаданных цитирования, состояния проверки и ссылок на официальные источники.
  • Используйте официальные страницы университета как источник формулировок политики.
  • Не рассматривайте анализ как совет, руководство по безопасности или подтверждение соответствия нормативным требованиям.
  • Совпадения по псевдонимам, темы и оценки охвата не создают фактов.
  • Записи об инструментах сформированы на основе текста утверждений и доказательств; они не заменяют формулировки официальных источников университета.

Рекомендуемая последовательность поиска

Безопасный порядок получения данных для агентов, которым нужны ответы с подтверждающими ссылками.

Сопоставить сущность

Вызов /api/public/v1/search.json?q=... или проверить /api/public/v1/entities/index.json чтобы найти каноническое обозначение (slug) университета. Совпадения по псевдонимам повышают полноту поиска, но не создают фактов.

Step1

Открыть каноническую запись

Загрузить /api/public/v1/universities/{slug}.json и сохраняйте канонический URL страницы, общедоступный JSON URL, статус проверки, дату последней проверки, ограничения и поля цитирования вместе с ответом.

Step2

Прикрепить доказательства утверждения

Загрузить /api/public/v1/claims/{slug}.json при необходимости повторного использования на уровне утверждений. Сохраняйте URL источников, язык источников, фрагменты доказательств, хеши снимков, уровень уверенности и статус проверки.

Step3

Использовать анализ как производные метаданные

Загрузить /api/public/v1/analysis/universities/{slug}.json только как детерминированные производные метаданные. Всегда указывайте базовые Claim ID и URL-адреса источников для непустых аналитических измерений.

Step4

Группы конечных точек

Записи, выпуски, виджеты, ленты и интеграции агентов.

Discovery

Индекс общедоступного API со ссылками на конечные точки, страницами о достоверности, правилами цитирования, ограничениями и метаданными версий.

Университеты

Список общедоступных записей университетов с каноническим URL страницы, URL общедоступного JSON, статусом проверки, датами и количественными показателями.

Поиск сущностей

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

Безопасный поисковый индекс

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

Индекс идентификации сущностей

Псевдонимы канонических сущностей университетов для повышения полноты поиска. Совпадение псевдонимов не создаёт общедоступных фактов о правилах.

Университетская запись

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

Утверждения об университетах

Строки утверждений и свидетельств одной общедоступной записи университета с URL и языком источника, хешем снимка, уверенностью и статусом проверки.

Каталог инструментов ИИ

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

Недавние изменения

Недавние проверки общедоступных источников и изменённые записи учреждений.

Индекс API анализа

Детерминированные аспекты анализа правил, пути конечных точек, ограничения и метаданные версии схемы.

Аналитический профиль университета

Подтверждённый источниками аналитический профиль с аспектами, идентификаторами подтверждающих утверждений, URL источников, уверенностью, статусом проверки и оценкой охвата правил.

Оценки охвата правил

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

Качество страницы анализа

Ограничения только для чтения: проверки качества страниц, статус индексируемости, рабочий процесс проверки аналитики и границы для публичных аналитических страниц, не дающих советов.

Охват QS 2026

Строки охвата сбора для целевых учреждений QS 2026 с полями общедоступности, наличия только в подготовке, отсутствия, числа источников, статуса проверки и следующего действия.

Состояние источников

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

Очередь проверки

Метаданные ещё не опубликованных подготовительных запусков со статусом валидации, широтой источников, обнаруженными идентификаторами URL и рекомендуемым следующим действием.

Релиз набора данных

Манифест выпуска с артефактами, числом строк, размерами в байтах, контрольными суммами SHA-256, цитированием и ограничениями.

Индекс отчётов

Индекс машиночитаемых отчётов с URL-адресами отчётов, метриками, ссылками на данные, лентами и обнаружением для информационной работы (outreach).

Данные диаграммы для отчёта

Готовые для диаграмм распределения последнего ежемесячного отчёта: языки источников, статусы проверки, охват регионов, городов и кампусов, а также рейтингов.

Пакет для распространения отчётов

Машиночитаемые тексты для СМИ, рассылок, писем исследователям и социальных сетей с явными границами использования.

Индекс виджетов

Данные для обнаружения виджетов с URL скрипта, поддерживаемыми виджетами, ограничениями и примером HTML.

Виджет статуса университета

Компактные данные виджета с актуальностью, статусом проверки, числом утверждений и источников, каноническими ссылками.

Виджет недавних изменений

Компактные данные недавних изменений для общедоступных виджетов проверки источников и изменений.

Виджет охвата политик

Компактные данные виджета охвата правил, подтверждённые источниками. Охват отражает широту, а не качество правил.

Виджет актуальности источников

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

Виджет статуса проверки

Компактные данные виджета статуса проверки с уверенностью и числом проверенных утверждений и утверждений-кандидатов.

Манифест альфа-версии MCP

Манифест проекта MCP только для чтения с допустимыми структурами инструментов, запрещёнными действиями и примерами запросов агентов.

Каталог инструментов MCP

Каталог инструментов альфа-версии MCP только для чтения со схемами входных данных, обязательными полями вывода и строго запрещёнными изменениями.

Правила ограничения частоты запросов

Машиночитаемые общедоступные правила добросовестного использования API, виджетов и доступа поисковых роботов.

Метаданные цитирования

Машиночитаемые шаблоны цитирования, обязательные поля, правила работы со свидетельствами, оговорка о правах на источники и граница, исключающая консультации.

Индекс вклада

Метаданные процесса внесения вклада только для чтения, URL шаблонов задач GitHub, меры защиты и правила публикации.

Правила проверки вкладов

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

Требования к цитированию и свидетельствам

Сохраняйте модель свидетельств при повторном использовании общедоступных данных.

  • Указывайте канонический URL страницы и общедоступный URL JSON вместе.
  • Сохраняйте URL источника, язык, хеш снимка, фрагмент доказательства, уровень уверенности и статус проверки при повторном использовании утверждения.
  • Уровень достоверности и статус проверки — отдельные поля.
  • Свидетельства на языке оригинала являются каноническими.
  • Не выдавайте машинные кандидаты или утверждения, требующие проверки, за окончательные выводы о политике.
  • Конечные точки для вкладов содержат только метаданные. Публичные отправки создают задачи на проверку через шаблоны GitHub Issues, а не напрямую канонические факты.

Контракт встраиваемых виджетов

Общедоступные виджеты используют тот же контракт API; для JSON встраиваемых виджетов и поиска сущностей включён CORS.

Встраивание JavaScript

Скрипт встраивания отображает компактную карточку Shadow DOM и читает только публичный JSON, специфичный для виджета. Он ведёт на канонические страницы трекера и не использует непроверенные формулировки утверждений.

Script/widgets/embed.js

Использование на нескольких сайтах

Эндпоинты JSON виджетов и публичный эндпоинт поиска сущностей содержат разрешающие заголовки CORS для общедоступного встраивания и поиска на стороне браузера. Другие публичные эндпоинты API остаются обычным JSON с ограничением одного источника (same-origin), если иное не оговорено отдельно.

CORSWidgets and search

Правила ограничения частоты запросов и работы поисковых роботов

Это общедоступные правила добросовестного использования, а не соглашение об уровне обслуживания платного API.

Рекомендуемый лимит
60 requests per minute per client for public JSON usage
Клиентский кэш
3600 секунд минимум
Массовое использование
Use dataset release artifacts instead of repeatedly walking per-university endpoints.
Использование краулеров
Use the sitemap, llms.txt, dataset manifest, and public API index. Do not bypass robots, login walls, paywalls, or university source-site terms.

This is a public fair-use policy, not a paid API SLA. Limits may be enforced or adjusted as traffic grows.