Migrace z API v1 na v2

Mapování polí a identifikátorů v1 → v2 a harmonogram ukončení v1.

API v2 · schemaVersion 2.1.0 · release m-ea8dfe (2026-10-21T19:25:45+02:00)

Mapování v1 → v2

v1	v2	Pozn.
`id` `lift:chora:A1`	`id` `lift:cerna-hora:a1` (+ alias `legacy-id`)	`https://data.skiresort.cz/api/v2/entities/lift:chora:A1` → 301
`lifts.type` (text), `typeCode`	`liftType` (číselník, např. `chairlift-4`, `t-bar`)	číselníky
`lifts.status`, `sourceStatusCode/Text`	`operations.sessions[].status` (+ `rawCode`, `observedAt`, `validUntil`)	stav ≠ schopnost
`lifts.nightSkiing`	relace `evening` ve `/status`; schopnost `nightSkiingCapable` u sjezdovek
`slopes.snowmaking`	`snowmakingCapable` (schopnost)
`slopes.difficulty` („střední“)	`difficulty` (`intermediate`) + `difficultyColor` (`red`)
`areas.gpsPosition` „15.75x50.64“	`latitude`, `longitude` (WGS 84)	v1 má prohozené pořadí
`areas.elevationRange` „625 - 1260“	`elevationMinMeters`, `elevationMaxMeters`
`areas.winter/summer.status`	`/api/v2/status` (`seasonPhase` + relace)
`services.*` (jeden typ)	`/pois`, `/services`, `/attractions`, `/summer-attractions`, `/skibus-lines`, `/snowparks`	podle typu
`weather.*`	`/api/v2/weather` (teploty z kamer s časem snímku)
`meta.sourceUpdatedAt`	`meta.dataAsOf`, `observedAt`

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.