---
title: "Migrace z API v1 na v2"
url: "https://data.skiresort.cz/docs/migrace-v1-v2"
lang: "cs"
schemaVersion: "2.1.0"
release: "m-fbe49f5fc6e5"
---

# 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-fbe49f (2026-10-21T20:50:15+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](https://data.skiresort.cz/docs/codelists) |
| `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` | |

## Harmonogram

- Do spuštění v2.0: v1 beze změny.
- Po spuštění v2.0: v1 posílá `Deprecation` a `Sunset` s odkazem na tuto stránku.
- Plánované ukončení v1: 30. 6. 2027 (pak `410 gone` s odkazem na v2).

## 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.