Changelog

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