CHANGELOG

Všechny významné změny specifikace XML feedu KNZ Integrations jsou zdokumentovány v tomto souboru.

\[1.1.0\] - 2026-07-20

Toto vydání předělává způsob popisu médií, zpřísňuje prodej vstupenek a zavádí nepovinné pole duration. Přidává rovněž jedno povinné pole (preview_url), které partneři musí ve svých feedech uvádět.

⚠️ Zásadní změny (Breaking changes)

Média už nejsou jedno pole **<media>** - nyní jsou to čtyři samostatná pole.

v1.0	v1.1	Poznámky
`<media><item type="image">` (první položka)	`<preview_url>`	Nyní povinné samostatně, neodvozuje se z pozice v poli
`<media><item type="image">` (jakákoli další položka)	`<gallery><item type="image">`	Přesunuto do bloku galerie
–	`<banner_url>`	Nové - nepovinný široký banner pro stránku s detaily akce
`<media><item type="document">`	`<attachment_url>`	Jedna URL; více souborů sloučte do jednoho ZIP archivu
–	`<gallery><item type="video">`	Nový typ položky galerie pro přímé video odkazy (YouTube/Vimeo), odlišný od `embed`

Původní obecné pravidlo vyžadující „alespoň jeden obrázek" bylo nahrazeno jediným přísným požadavkem: musí být přítomno pole preview_url. Pole galerie je nepovinné a lze jej vynechat nebo předat jako prázdný seznam.

Změna HTTP User-Agenta (crawleru):

Původní User-Agent KamNaZapade/1.0 byl nahrazen novým KNZCrawler/1.0.

Upozornění pro partnery: Pokud na svých webových serverech (Nginx, Cloudflare, WAF) filtrujte přístup na základě User-Agenta, je nutné přidat KNZCrawler/1.0 na whitelist, jinak budou požadavky na stahování feedu odmítnuty.

✨ Nová pole

**duration**: Přidán nepovinný podřízený element <duration> přímo pod <event> pro určení délky trvání akce v minutách (např. <duration>90</duration>).
Vylepšení vnořených událostí (**<nested_event>**):
Přidána podpora bloku <ticket> přímo uvnitř vnořených událostí.
Přidána podpora pole <preview_url> pro náhledový obrázek vnořené události.

Změny v prodeji vstupenek

Struktura elementu <ticket> byla aktualizována pro lepší konzistenci se zbytkem schématu:

**status** přesunut do podřízeného elementu: Stav se již nepředává jako atribut XML.
Aktualizované hodnoty výčtu (enum): Hodnoty status jsou nyní striktně on_sale, sold_out, not_yet_available nebo free (pozn.: at_door bylo přesunuto).
Nové pole **sales_channel**: Přidán nepovinný podřízený element <sales_channel> pro určení distribučního kanálu (online nebo at_door).

Porovnání struktury XML:

- <ticket status="on_sale">
-     <price_min>450</price_min>
- </ticket>
+ <ticket>
+     <status>on_sale</status>
+     <sales_channel>online</sales_channel>
+     <price_min>450</price_min>
+ </ticket>