Specifikace exportovaných dat / API

Možnosti exportu ve formátu XML

URL pro export dat: http://opendata.mesto-kromeriz.cz/akce/export/export-xml.

Typ exportu a ostatní parametry se předávají metodou GET.

Možné GET parametry

export_type

určuje jaký typ exportu je požadován. Možnosti jsou:

  • event_date - data budou vybírána dle data konání akce (default)
  • event_last_edit - data budou vybírána dle data poslední úpravy akce

from

datum od kterého se má provádět výpis akcí.

  • při parametru export_type=event_date ve formátu dd.mm.YYYY
  • při parametru export_type=event_last_edit ve formátu dd.mm.YYYY HH:ii

to

datum do kterého se má provádět výpis akcí(včetně).

  • při parametru export_type=event_date ve formátu dd.mm.YYYY
  • při parametru export_type=event_last_edit ve formátu dd.mm.YYYY HH:ii

place_id

Id místa, které chci nechat exportovat. Pokud je rovno nule, exportuje všechna místa.

type

Id typu akce, který chci nechat exportovat. Pokud je rovno nule, exportuje všechny typy.

Struktura dat souboru XML

(Formát datetime: YYYY-mm-dd HH:ii:ss)

<export_data>
  <events>
    <event>
      <id>Unikátní id (id termínu akce) (int)</id>
      <event_id>Id akce (v seznamu může být více termínů jedné akce) (int)</event_id>
      <name>Název akce (string)</name>
      <perex>Krátký popis akce(string)</perex>
      <text>Doprovodný text k akci (string)</text>
      <time_from>Datum a čas začátku akce (datetime)</time_from>
      <time_to>Datum a čas konce akce (datetime)</time_to>
      <note>Poznámka k termínu (poznámka se uvádí v závorce za názvem akce) (string)</note>
      <ticket_url>Odkaz na nákup lístku online (string)</ticket_url>
      <type>Typ akce (viz event_types) (int)</type>
      <place>ID místa akce (viz places) (int)</place>
      <for_kids>Je akce určená dětem? (bool)</for_kids>
      <free_entrance>Je akce zdarma? (bool)</free_entrance>
      <price>Cena akce (pokud je 0, cena není uvedena) (int)</price>
      <price_note>Poznámka k ceně (slevy, dobrovolné vstupné atd.) (string)</price_note>
      <web>Odkaz na stránky akce (string)</web>
      <fb>Odkaz na facebookové stránky akce (string)</fb>
      <youtube>11-ti místný kód pro youtube video (string)</youtube>
      <image>URL umístění obrázku na serveru opendata.mesto-kromeriz.cz (string)</image>
      <last_edit>Datum poslední úpravy akce (datetime)</last_edit>
      <term_last_edit>Datum poslední úpravy termínu akce (datetime)</term_last_edit>
    </event>
  </events>
  <places>
    <place>
      <id>ID místa (int)</id>
      <label>Název místa (string)</label>
      <web>Web místa (string)</web>
    </place>
  </places>
  <event_types>
    <event_type>
      <id>ID typu akce (int)</id>
      <label>Štítek typu akce (string)</label>
    </event_type>
  </event_types>  
</export_data>

Možnosti exportu ve formátu TXT

URL pro export dat: http://opendata.mesto-kromeriz.cz/akce/export/export-txt.

Typ exportu a ostatní parametry se předávají metodou GET. Parametry jsou totožné s exportem do XML.