Verejné API katalógu odpadov

Celý katalóg ako statické JSON súbory. Bez kľúča, bez registrácie, bez limitov — podmienkou je uvedenie zdroja s odkazom.

Endpointy

• /api/v1/kody.json Všetkých 847 druhov odpadu — kód, názov, kategória O/N, skupina, podskupina, URL detailu.
• /api/v1/skupiny.json 20 skupín katalógu s podskupinami a počtami druhov (z toho nebezpečných).
• /api/v1/kod/17-05-04.json Detail jedného kódu vrátane skupiny, podskupiny a ostatných kódov tej istej podskupiny. Slug je rovnaký ako v URL stránky kódu.

Ukážka odpovede

{
  "zdroj": "Katalóg odpadov",
  "web": "https://katalog-odpadov.sk/",
  "predpis": "vyhláška č. 365/2015 Z. z., ktorou sa ustanovuje Katalóg odpadov, príloha č. 1",
  "kod": "17 05 04",
  "kod_slug": "17-05-04",
  "nazev": "…",
  "kategorie": "O",
  "nebezpecny": false,
  "skupina": "17",
  "podskupina": "17 05",
  "url": "https://katalog-odpadov.sk/kod/17-05-04/"
}

Poznámky k použitiu

• API je statické — nemá parametre dopytu. Filtrovanie podľa „?q=“ neexistuje: stiahnite /api/v1/kody.json a filtrujte na svojej strane (súbor má pod 300 kB a hosting ho posiela komprimovane).
• Odpovede majú hlavičku Access-Control-Allow-Origin: *, takže sa dajú čítať z prehliadača na cudzej doméne.
• Dáta sa aktualizujú len pri zmene vyhlášky. Odpovede je rozumné cachovať na hodiny až dni.
• Hľadáte hotové vyhľadávacie pole namiesto dát? Použite vložiteľný widget. Vyhľadávač kódov odpadu na váš web

Podmienky použitia

• API je bezplatné, bez registrácie, kľúča aj limitov. Ide o statické súbory, takže unesie aj vyššiu prevádzku.
• Podmienkou použitia je uvedenie zdroja s odkazom na katalog-odpadov.sk — pri tabuľke, v pätičke aplikácie alebo v dokumentácii, podľa toho, kde dáta zobrazujete.
• Dáta sa nesmú vydávať za vlastný katalóg a nesmie sa z nich odstraňovať kategória O/N — to je právne najcitlivejšie pole.
• Štruktúra odpovedí (názvy kľúčov) sa v rámci /api/v1/ nebude meniť; prípadná nekompatibilná zmena dostane /api/v2/.
• Katalóg je pomôcka, nie právne stanovisko. Záväzné je znenie vyhlášky, na ktoré každá odpoveď odkazuje poľom predpis_url.