Запросы не меняют публичную запись и не дают доступа к рабочим материалам.
публичные данные
Документация API
Версионированный API QAZ.EXPERT помогает находить и читать уже опубликованные сведения о Казахстане. Он работает только на чтение и возвращает происхождение данных вместе с результатом.
Новый фасад дополняет, а не заменяет действующие маршруты сайта.
первый запрос
Поиск и разрешение идентификатора
Начните с поиска, когда известны название, алиас или написание на другом языке. Если нужен один объект, используйте resolve: ответ различает найденный объект, омонимию и отсутствие результата.
GET /api/v1/search
Параметр q обязателен. Можно указать locale=ru|kk|en, limit от 1 до 100 и курсор следующей страницы.
POST /api/v1/resolve
Передайте запрос в JSON. Используйте статус ответа и список кандидатов, а не выбирайте совпадение автоматически при неоднозначности.
Canonical ID
Сохраняйте stable ID из ответа. URL, slug, язык и внешние идентификаторы могут меняться как алиасы или версии.
curl 'https://qaz.expert/api/v1/search?q=%D0%91%D0%B0%D0%B9%D0%BA%D0%BE%D0%BD%D1%83%D1%80&locale=ru&limit=10'формат ответа
Как читать результат
Все маршруты v1 используют один конверт: data, meta и links. В meta передаются версия схемы и revision публичной проекции; у коллекций также есть счётчик и next_cursor.
Связи и доказательства
Маршруты relations, claims, evidence и sources дают читателю связь между объектом, утверждением и опубликованным источником.
Данные и география
Indicators, observations, datasets, places и geometry сохраняют единицу, период, географию, источник и revision там, где эти поля опубликованы.
Ошибки
Ошибочный запрос получает структурированную ошибку; не используйте отсутствие результата как подтверждение отсутствия факта.
версии и изменения
Неизменяемые срезы
Коллекции releases и snapshots содержат только запечатанные неизменяемые записи. changes – вычисленная разница между последовательными такими выпусками, а не редактируемый журнал.
GET /api/v1/releases
Возвращает сведения о выпуске только после появления полного набора доказательств выпуска.
GET /api/v1/snapshots
Возвращает дескрипторы неизменяемых срезов; до первого зарегистрированного выпуска коллекция может быть пустой.
GET /api/v1/changes
Показывает изменившиеся публичные проекции между двумя последовательными запечатанными выпусками.
доступ
Лимиты и условия использования
Для /api/v1/ действует лимит 60 запросов в минуту на исходный адрес; разрешён всплеск до 30 запросов. При превышении сервер возвращает HTTP 429. Проверка готовности /api/v1/health не входит в этот лимит. Максимальный размер тела запроса – 16 KiB.
Права на данные
Условия повторного использования определяет первичный источник. QAZ.EXPERT публикует только безопасные агрегаты и метаданные; перед использованием откройте паспорт нужного набора и его источник.
Лицензирование
Не выводите лицензию из отсутствующего поля. Условия и ограничения привязаны к конкретному набору или источнику.
Полный контракт
OpenAPI 3.1 содержит схему запросов, ответов и ошибок для всех маршрутов v1.