Datové schéma a požadavky
Povinná a nepovinná pole události, formáty hodnot a validační pravidla.
Tato specifikace definuje povinnou XML strukturu pro vstup dat o událostech. Aby synchronizace s naší databází proběhla úspěšně, musí váš feed dodržovat zde uvedené datové typy a omezení.
1. Hlavní data události (kořen: <event>)
Následující tabulka popisuje prvky události na nejvyšší úrovni. Pole označená jako povinná jsou pro proces synchronizace bezpodmínečně nutná.
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
id | String | Ano | Vaše interní unikátní ID (max. 255 znaků). |
title | String | Ano | Oficiální název události tak, jak se zobrazí na platformě. |
description | Text | Ano | Plný popis. HTML tagy nejsou povolené. Pro zalomení řádku použijte |
language | String | Ano | Jazyk, ve kterém událost probíhá. Použijte ISO 639-1 kód (např. |
start_date | ISO8601 | Ano | Časový údaj ISO 8601 s časovou zónou — s posunem ( |
end_date | ISO8601 | Ne | Konec události. Vícedenní událost bez |
copyright_acknowledged | Boolean | Ano | Potvrzení vlastnictví obsahových práv. Hodnota musí být |
facebook_url | String | Ne | Odkaz na událost nebo stránku na Facebooku. Web ho ukáže na stránce akce jako „Událost na Facebooku“; adresu bez |
duration | Number | Ne | Délka trvání události v minutách. Na stránce akce se ukáže jako „Trvá …“ (např. „Trvá 1 h 30 min“). |
preview_url | String | Ano | URL adresa primárního obrázku (titulní obrázek / náhled). |
banner_url | String | Ne | URL adresa banneru pro stránku s detailem události. |
attachment_url | String | Ne | URL adresa souboru ke stažení (PDF, program atd.). |
gallery | Array | Ne | Seznam dalších obrázků a videí. |
location | Object | Ano | Fyzické místo konání a geografické souřadnice. (Viz část 2.1) |
taxonomies | Object | Ano | Klasifikační štítky, kategorie a prvky přístupnosti. Viz příklad na konci stránky Taxonomie nebo celkovou ukázku XML feedu. |
recurrence | Object | Ne | Konkrétní rozvrh pro události opakující se v určitém období. (Viz sekce 2.2) |
nested_events | Array | Ne | Vnořené události propojené s hlavní nadřazenou událostí. (Viz sekce 2.3) |
participants | Array | Ne | Seznam herců, řečníků nebo účinkujících (Viz sekce 2.4). |
ticket | Object | Ne | Komerční stav a tvorba cen pro jedno vstupní místo. (Viz sekce 2.5) |
Časová zóna. Posílá-li váš systém místní čas označený jako UTC (19:00:00Z pro představení v 19:00), dejte nám vědět: u vašeho zdroje nastavíme časové pásmo (např. Europe/Prague) a časy z feedu budeme číst jako místní — posun uvedený ve feedu se pak nebere v úvahu. Opraví se i dříve načtené události (u zveřejněných po schválení redakcí).
2. Specifikace dílčích objektů
2.1 Detaily místa konání (<location>)
Každá událost musí být fyzicky lokalizovatelná, aby se zobrazila v mapách a ve vyhledávání podle polohy.
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
name | String | Ano | Veřejný název místa konání. |
city | String | Ano | Slug města z oficiálního seznamu (např. |
address | Text | Ne | Fyzická adresa (volitelné u akcí v terénu nebo v odlehlých lokalitách). |
latitude | Real | Ano | Desetinná souřadnice (např. |
longitude | Real | Ano | Desetinná souřadnice (např. |
2.2 Opakování a rozvrh (<recurrence>)
Definuje týdenní otevírací dobu pro sezónní nebo opakující se výstavy.
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
name | Atribut (Enum) | Ano | Den v týdnu (např. |
start | Atribut (Time) | Ano | Čas otevření ve 24hodinovém formátu ( |
end | Atribut (Time) | Ano | Čas zavření ve 24hodinovém formátu ( |
2.3 Hierarchie vnořených událostí (<nested_event>)
Umožňuje navázat více dílčích vystoupení na jednu zastřešující rodičovskou událost.
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
id | String | Ano | Unikátní a neměnné ID vnořené události na straně poskytovatele; podle něj položku programu aktualizujeme. |
title | String | Ano | Název konkrétního vystoupení nebo programu. |
start_date | DateTime | Ano | Plný ISO 8601 timestamp s časovou zónou. |
end_date | DateTime | Ne | Plný ISO 8601 timestamp s časovou zónou. Bez něj spočítáme konec z |
preview_url | String | Ne | URL adresa náhledového obrázku konkrétního vystoupení. |
duration | Number | Ne | Délka trvání vnořené události v minutách (např. |
location | String | Object | Ne | Pokud String: název sálu nebo pódia. Pokud Object: detaily místa konání (stejná struktura jako v části 2.1) — přiřadíme ho k místu z našeho katalogu se stejnými souřadnicemi, jinak jeho |
ticket | Object | Ne | Komerční stav a tvorba cen pro konkrétní vnořenou událost (stejná struktura jako v části 2.5). |
2.4 Účinkující (<participants>)
Tento blok umožňuje uvést klíčové osoby spojené s událostí (např. herecké obsazení, řečníky festivalu nebo hudební umělce).
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
id | String | Ano | Unikátní ID osoby na straně poskytovatele. |
name | String | Ano | Plné jméno účinkujícího. |
role | String | Ne | Role, ve které vystupuje (např. „Hlavní herec", „Moderátor", „DJ"). |
avatar | String | Ne | Veřejný přímý odkaz (HTTPS) na fotografii. |
bio | Text | Ne | Krátký profesní životopis. |
2.5 Vstupenky a dostupnost (<ticket>)
Systém podporuje jednu primární vstupenku na záznam události. Pokud existuje více cenových úrovní, uveďte cenu od.
Prvek | Typ | Povinné | Popis |
|---|---|---|---|
status | Enum | Ano | Jedna z hodnot: |
sales_channel | Enum | Ne | Jedna z hodnot: |
price_min | String | Podmíněně | Nejnižší dostupná cena (např. |
price_max | String | Ne | Nejvyšší dostupná cena (např. |
url | String | Ne | Přímý odkaz na externí stránku s prodejem vstupenek. Pokud je |
Událost bez <ticket> web ukáže bez ceny i bez štítku „Zdarma“ — chybějící blok neznamená vstup zdarma. Položky programu bez vlastního <ticket> přebírají vstupenku události. Podrobnosti na stránce Vstupenky.
Aktualizováno 16. října 2026