{
  "schema_version": "qaz-farm-partner-api-catalog-v1",
  "api_version": "v1",
  "release_id": "2026-08-21.1",
  "catalog_release_id": "2026-08-14.1",
  "status": "stable-read-only",
  "base_url": "https://qaz.farm",
  "generated_at": "2026-08-21T00:10:00+05:00",
  "data_as_of": "2026-08-20",
  "authentication": "none",
  "allowed_methods": ["GET", "HEAD"],
  "write_operations": false,
  "same_origin_runtime": true,
  "compatibility": {
    "policy": "additive-within-v1",
    "breaking_change": "publish-a-new-api-version",
    "release_identity": "/thematic-release.json",
    "source_status": "/source-status.json"
  },
  "privacy": {
    "personal_data": false,
    "commercial_farm_records": false,
    "exact_farm_or_field_coordinates": false,
    "raw_intake": false
  },
  "resources": [
    {
      "id": "national-snapshot",
      "path": "/data/agri-snapshot.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Национальные показатели и проверенные обновления с периодами и источниками."
    },
    {
      "id": "historical-series",
      "path": "/data/historical-series.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Национальные временные ряды и наблюдения с provenance."
    },
    {
      "id": "region-profiles",
      "path": "/data/region-profiles.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Публичные агрегированные профили 20 регионов."
    },
    {
      "id": "region-geometry",
      "path": "/data/qazgeo-regions.geojson",
      "media_type": "application/geo+json",
      "schema_version_field": false,
      "description": "Публичная региональная геометрия QazGeo без географии хозяйств."
    },
    {
      "id": "regional-crops",
      "path": "/data/bns-regional-crops.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Региональные показатели растениеводства БНС."
    },
    {
      "id": "regional-livestock",
      "path": "/data/bns-regional-livestock.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Региональные показатели животноводства БНС."
    },
    {
      "id": "agricultural-prices",
      "path": "/data/bns-agri-prices.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Опубликованные БНС цены по сельскохозяйственным категориям."
    },
    {
      "id": "trade-observations",
      "path": "/data/trade-observations.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Проверенный пилот UN Comtrade по четырём зерновым кодам."
    },
    {
      "id": "water-season",
      "path": "/data/water-season-2026.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Публичные лимиты водопользования и агрегированная динамика."
    },
    {
      "id": "grain-storage",
      "path": "/data/grain-storage-snapshots.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Датированные официальные снимки зернохранилищ с разделёнными методиками."
    },
    {
      "id": "soilgrids-reference-points",
      "path": "/data/soilgrids-reference-points.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Региональные референсные точки SoilGrids с диапазонами неопределённости."
    },
    {
      "id": "support-services",
      "path": "/data/support-services.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Официальные маршруты поддержки и опубликованные сроки без eligibility-решений."
    },
    {
      "id": "science-registry",
      "path": "/data/science-registry.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Библиографический реестр исследований с областью применимости."
    },
    {
      "id": "source-registry",
      "path": "/data/source-registry.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Stable IDs, права, периоды и состояние первичных источников."
    },
    {
      "id": "freshness-registry",
      "path": "/data/freshness-registry.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Вычисляемые fresh, stale и reference статусы, даты проверки, версии источников и критичность публичных наборов."
    },
    {
      "id": "qaz-events-data-channel",
      "path": "/data/data-channel-manifest.json",
      "media_type": "application/json",
      "schema_version_field": true,
      "description": "Манифест текущего атомарного bundle Qaz.Events с SHA-256 для JSON и ICS и явным статусом свежести."
    }
  ],
  "limitations": [
    "Редакционные наборы обновляются только проверенными выпусками; машинный календарь Qaz.Events может обновляться отдельным валидированным data-channel.",
    "Период, единица, источник и ограничение читаются из каждого набора.",
    "API не является прогнозом, профессиональной рекомендацией или решением о праве на поддержку.",
    "CORS для произвольных внешних origin не является частью v1; серверное повторное использование должно соблюдать права исходного набора."
  ]
}