QAZ.WINE
QAZ.WINE для разработчиков
Опубликованные данные QAZ.WINE доступны через API только для чтения, без ключа доступа. Ответы API возвращаются в JSON; готовые выгрузки доступны в нескольких форматах.
Адреса API
| Назначение | Адрес | Описание |
|---|---|---|
| Карточки | `/api/v1/entities` | Параметры: type, limit, offset. |
| Одна карточка | `/api/v1/entities/grape:aligote` | Пример карточки Aligote. Идентификатор другой записи берётся из списка карточек. |
| Поиск | `/api/v1/search?q=` | Параметр q; поиск по русским и латинским написаниям. |
| География | `/api/v1/atlas` | Места и производители с точностью привязки. |
| Источники | `/api/v1/sources` | Материалы и сохранённые даты обращения. |
| Утверждения | `/api/v1/claims` | Сведения карточек и их источники. |
| Основания | `/api/v1/evidence` | Связи утверждений, источников и выпусков данных. |
| Выпуски данных | `/api/v1/dataset-releases` | Опубликованные версии набора и даты выпусков. |
| Выгрузка карточек | `/api/v1/exports/entities.json` | Все опубликованные карточки одним файлом. |
Типы и значения
Выпуск вина относится к одному указанному году. Продуктовая карточка вина может не иметь указанного года или содержать несколько годов. Группа вин описывает несколько продуктов, поэтому единый год для неё не применяется.
Rkatsiteli Reserve — один продукт с урожаями 2017 и 2019 годов. Его идентификатор сохраняется в обеих годовых подборках. Неизвестный год нельзя заменять нулём или обозначением NV.
Сорта в купаже связаны с вином только при явно названном составе. Географическое значение передаётся вместе с ролью места и точностью: адрес предприятия, регион выращивания и местоположение виноградника различаются.
Готовые файлы
- Карточки справочника — JSON
- Карточки справочника — JSON Lines
- Карточки справочника — CSV
- Карточки справочника — Parquet
- Географические записи — GeoJSON
Версии и воспроизводимость
Карточки, источники и география обновляются в составе выпуска набора данных. Сохраняйте идентификаторы записей, версию набора и дату среза. Версия сборки доступна в release.json; история выпусков данных — через /api/v1/dataset-releases.
Данные · Источники · О проекте
Страница «Источники» сохраняет исходный реестр и дополнения. В /api/v1/sources входят материалы, связанные с опубликованными утверждениями; /api/v1/verification содержит отдельно датированные слои проверок. Поэтому количество источников в этих разделах различается. Ссылки self и next сохраняют запрос и применённые фильтры.