Read-only JSON API

Veřejné API katalogu odpadů

Celý katalog jako statické JSON soubory. Bez klíče, bez registrace, bez limitů — podmínkou je uvedení zdroje s odkazem.

Endpointy

/api/v1/kody.json Všech 842 druhů odpadu — kód, název, kategorie O/N, skupina, podskupina, URL detailu.
/api/v1/skupiny.json 20 skupin katalogu s podskupinami a počty druhů (z toho nebezpečných).
/api/v1/kod/17-05-04.json Detail jednoho kódu včetně skupiny, podskupiny a ostatních kódů téže podskupiny. Slug je stejný jako v URL stránky kódu.

Ukázka odpovědi

{
  "zdroj": "Katalog odpadů",
  "web": "https://katalogodpadu.cz/",
  "predpis": "vyhláška č. 8/2021 Sb., o Katalogu odpadů a posuzování vlastností odpadů, příloha č. 1",
  "kod": "17 05 04",
  "kod_slug": "17-05-04",
  "nazev": "…",
  "kategorie": "O",
  "nebezpecny": false,
  "skupina": "17",
  "podskupina": "17 05",
  "url": "https://katalogodpadu.cz/kod/17-05-04/"
}

Poznámky k použití

API je statické — nemá parametry dotazu. Filtrování podle „?q=“ neexistuje: stáhněte /api/v1/kody.json a filtrujte na své straně (soubor má pod 300 kB a hosting ho posílá komprimovaně).
Odpovědi mají hlavičku Access-Control-Allow-Origin: *, takže je lze číst z prohlížeče na cizí doméně.
Data se aktualizují jen při změně vyhlášky. Odpovědi je rozumné cachovat na hodiny až dny.
Hledáte hotové vyhledávací pole místo dat? Použijte vložitelný widget. Vyhledávač kódů odpadu na váš web

Podmínky užití

API je bezplatné, bez registrace, klíče i limitů. Jde o statické soubory, takže je unese i vyšší provoz.
Podmínkou použití je uvedení zdroje s odkazem na katalogodpadu.cz — u tabulky, v patičce aplikace nebo v dokumentaci, podle toho, kde data zobrazujete.
Data se nesmí vydávat za vlastní katalog a nesmí se z nich odstraňovat kategorie O/N — ta je právně nejcitlivější pole.
Struktura odpovědí (názvy klíčů) se v rámci /api/v1/ nebude měnit; případná nekompatibilní změna dostane /api/v2/.
Katalog je pomůcka, ne právní stanovisko. Závazné je znění vyhlášky, na které každá odpověď odkazuje polem predpis_url.