---
title: "Changelog"
url: "https://data.skiresort.cz/docs/changelog"
lang: "cs"
schemaVersion: "2.1.0"
release: "m-fbe49f5fc6e5"
---

# Changelog

Změny produktu a schématu API v2.

API v2 · schemaVersion 2.1.0 · release m-fbe49f (2026-10-21T20:50:15+02:00)

## Produkt

### 2.1.0 – 21. 10. 2026

- **Licence a atribuce:** Holidayinfo / Sitour CZ je smluvně schválený zdroj (smlouva MEGA PLUS s.r.o. se Sitour CZ) – texty o omezené betě a podmíněném předávání odstraněny. Nové pole `meta.attributions` = pole `{sourceId, text, licence, url}` (Data Hub + zdroje použité v odpovědi, i v MCP); `meta.attribution` (jen texty) zůstává, je zastaralé. Licence vlastních dat (návrh CC BY 4.0) se po schválení vlastníkem uvede v `meta.license`, JSON-LD `Dataset` a ve front matter.
- **Provoz:** editorská poznámka relace (`note`, např. výluka) v API, na /status, fact pages, llms-full i v MCP `get_live_status`; nepotvrzený stav má `validUntil: null` a `unconfirmedSince` (platnost se bez nového pozorování neposouvá); /status mimo sezónu stručně (fáze, co jede, poznámky, ostatní sbalené s počtem). Kontroly kvality mají `coverage` (nulové pokrytí = `skipped`). Hlavičky `X-Master-Release` a `X-Status-Snapshot`: master stránky a dokumentace mají ETag a platnost nezávislé na potvrzování stavů. SLO potvrzení stavu v sezóně ≤ 30 min.
- **Ceny a věkové kategorie:** ceníky v `/prices` nesou `priceStatus` (confirmed, provisional, unpublished, archived), `validFrom`, `validTo`, `salesChannels`, `bookableNow`, `purchaseUrl`, `verifiedAt`; archiv minulé sezóny nikdy mezi aktuálními, Offer v JSON-LD jen u potvrzených cen; poznámka „ceník skipasů 2026/27 zatím nebyl zveřejněn; poslední archiv 2025/26“. Věkové kategorie po cenících: kategorie platná jen pro ceník (Malé vleky 2025/26, výLETNÍ sezónka a EnjoyCard) má vlastní sadu (`priceList`, `productIds`); `/age-categories?product=` vrací sadu ceníku produktu – každý ročník narození právě v jedné kategorii. FAQ mají `seasonId`, `validFrom`, `validTo`, `seasonSensitive` a větu „Platí pro sezónu X“.
- **Fronta ke schválení:** lidská rozhodnutí z auditu (licence, ceny a věkové kategorie 2026/27, souhrnná čísla, konflikty, jazyky, SLA) čekají v administraci; nic se nemění potichu.

### 2.0.0-beta.1 – 17. 10. 2026

- **I4 – kontroly kvality dat:** kontroly při stavbě releasu (zakázané vzory, sezónní brána, pokrytí věkových kategorií, schéma registru, povinné atributy, konflikty, souhrny km a počtů proti tvrzení oficiálního webu, visící odkazy, proti předchozímu releasu, velikosti, hygiena textů, publikační minimum) jsou součástí releasu a logu; blokující brána (`QC-PUB-03`, `QC-O-02`) release nepublikuje. `/api/v2/quality` doplňuje kontroly čerstvosti vs. SLO (`QC-SLO-01`–`04`) v okamžiku požadavku a pole `stage`, `action`, `gate`, `count`, `data`. ID kontrol sjednocena s katalogem kvality: `QC-G-01` → `QC-RES-01`, `QC-M-01` → `QC-RES-03`, `QC-M-02` → `QC-REF-01`, `QC-M-03` → `QC-PUB-01`, `QC-G-02` → `QC-PUB-03`, stale stavy `QC-O-01` → `QC-SLO-02` (`QC-O-01` nově = stav bez `observedAt`/`validUntil`).
- **I3 – kanály pro LLM, AI vyhledávače a agentury:** OpenAPI 3.1 generované ze Zod (`/openapi.json`, `/openapi.yaml`), dokumentační portál `/docs` (API reference, datový slovník, číselníky, glosář), serverově renderované fact pages s JSON-LD a Markdown variantou, `/llms.txt`, `/llms-full.txt`, `/robots.txt`, `/sitemap.xml` s `lastmod` podle změny faktů, read-only MCP server `/mcp`, URI identit `/id/…`. API v2: `url` entit vede na fact page, detail entity umí `application/ld+json` a `text/markdown`, hlavička `Link` s `service-desc`/`service-doc`, `meta.docs`.
- **I2 – veřejné API v2:** kolekce všech typů registru, `/status`, `/weather`, `/prices`, `/age-categories`, `/search`, `/quality`, `/releases/latest`; ETag/304, Cache-Control, CORS, problem+json.
- **I1 – kanonické jádro:** typovaný registr, claims s provenance, resolver priorit zdrojů, neměnné releasy.

## Schéma (generováno z registru)

- `schemaVersion`: `2.1.0` · otisk registru `90a36810`
- 38 typů entit, 151 atributů (145 veřejných).
- 2.1.0: jen aditivní změny (`meta.attributions`, `note`, `unconfirmedSince`, `coverage`, `priceStatus` a další pole ceníků, `priceList`/`productIds` věkových sad, sezónní pole FAQ); nic se neodebírá.

## Dokumentace

- [Data Hub pro agentury a vývojáře](https://data.skiresort.cz/docs) – Co Data Hub obsahuje, jak číst identifikátory, stavy, čas, cache, verze a licence – s příklady volání.
- [API reference (OpenAPI 3.1)](https://data.skiresort.cz/docs/api) – Interaktivní reference veřejného API v2 generovaná z OpenAPI 3.1.
- [Datový slovník](https://data.skiresort.cz/docs/data-dictionary) – Typy entit a jejich atributy z registru domény: jednotky, vrstvy, rodiny, časovost a mapování.
- [Číselníky](https://data.skiresort.cz/docs/codelists) – Kódy typů lanovek, obtížností, stavů, relací, důvodů, sezónních fází, kategorií služeb a druhů zdrojů.
- [Glosář pojmů](https://data.skiresort.cz/docs/glossary) – Pojmy resortu (SkiTour, Flexiskipas, sKiosek…) s definicemi z aktuálního releasu.
- [Pro AI agenty: MCP, OpenAPI a llms.txt](https://data.skiresort.cz/docs/mcp) – Read-only MCP server, nástroje, limity a jak citovat data.
- [Changelog](https://data.skiresort.cz/docs/changelog) – Změny produktu a schématu API v2.
- [Licence a atribuce](https://data.skiresort.cz/docs/licence) – Za jakých podmínek lze data použít a jak uvádět zdroje.
- [Migrace z API v1 na v2](https://data.skiresort.cz/docs/migrace-v1-v2) – Mapování polí a identifikátorů v1 → v2 a harmonogram ukončení v1.
