Pro vývojáře

Všechna data z katalogu jsou k dispozici strojově: soubory se stálou adresou, REST API bez registrace, lokální katalog podle národní normy DCAT-AP-CZ a kanál novinek.

REST API

Bez registrace a bez klíče, jen čtení, odpovědi v JSON (UTF-8), CORS povolen pro všechny domény. Nejvýš 300 požadavků za minutu z jedné adresy — na celá data použijte soubory ke stažení.

• Popis rozhraní (OpenAPI 3): https://opendata.liberec.cz/api/v1/openapi.json
• Seznam sad: https://opendata.liberec.cz/api/v1/sady (parametry q = hledaný text, tema = kód tématu, např. ENVI)
• Metadata sady: …/sady/{identifikátor}, data tabulkové sady: …/sady/{identifikátor}/data
• Data: limit (nejvýš 1000), offset, razeni=sloupec nebo razeni=-sloupec (sestupně), filtr rovností sloupec=hodnota, format=csv. Odpověď obsahuje odkaz dalsi na další stránku.

Příklad (sada „Liberec v číslech — ukazatele města“):

curl "https://opendata.liberec.cz/api/v1/sady/liberec-v-cislech"

Soubory ke stažení

Tabulkové sady aplikace při každém zveřejnění vytvoří ve formátech CSV (s popisem sloupců CSVW), JSON (se schématem JSON Schema), XML (s XSD), XLSX, ODS, u dat s polohou GeoJSON a KML, u sad podle otevřené formální normy navíc JSON-LD. Stálá adresa souboru vede vždy na poslední verzi; každá verze zůstává i ve vlastní složce v1, v2… U souborů je uveden otisk SHA-256.

Lokální katalog pro Národní katalog dat

Metadata všech sad podle DCAT-AP-CZ (verze 2026-09-23) jako JSON-LD: https://opendata.liberec.cz/lkod/katalog/00262978. Záznam každé sady je na adrese …/lkod/sady/{identifikátor}. Odtud si data stahuje Národní katalog dat.

Otevřené formální normy

Některé sady odpovídají národním normám (OFN) — data pak můžete načíst stejným kódem jako data jiných měst:

• Sběrné dvory — norma https://ofn.gov.cz/sběrné-dvory/2022-04-19/
• Nádoby na tříděný odpad — norma https://ofn.gov.cz/nádoby-na-tříděný-odpad/2022-04-19/
• Sportoviště — norma https://ofn.gov.cz/sportoviště/2020-07-01/
• Turistické cíle — norma https://ofn.gov.cz/turistické-cíle/2020-07-01/
• Události — norma https://ofn.gov.cz/události/2020-07-01/
• Aktuality — norma https://ofn.gov.cz/aktuality/2020-07-01/
• Pracovní místa — norma https://ofn.gov.cz/pracovní-místa/2021-09-23/

Novinky

Nové a aktualizované sady jako kanál Atom: https://opendata.liberec.cz/feed.php.

Podmínky užití

Podmínky jsou u každé sady (v metadatech i v souborech XLSX/ODS na listu Metadata). Většina dat je bez omezení; kde je licence CC BY 4.0, uveďte autora podle návodu „Jak citovat“ u sady.