Data obce pro vaše aplikace

Všechno, co web ukazuje — novinky, úřední desku, usnesení a zápisy zastupitelstva, chystané akce, hladinu Bystré, webkamery a články — si můžete stáhnout jako JSON a použít ve vlastní aplikaci, na jiném webu nebo v chytré domácnosti.

Nepotřebujete registraci ani klíč. API umí data jen číst.

Adresa API

https://markvartice.net/api/v1

Strojově čitelný popis ve formátu OpenAPI 3.1: https://markvartice.net/api/v1/openapi.json

Co v API najdete

Adresa	Co vrátí
GET /	Rozcestník se seznamem endpointů a odkazem na dokumentaci
GET /openapi.json	Tento popis API ve formátu OpenAPI 3.1
GET /news	Nejnovější novinky z obce
GET /news/{id}	Jedna novinka i s celým textem
GET /office-desk	Úřední deska — výchozí je jen to, co dnes visí
GET /office-desk/{id}	Jeden dokument z úřední desky i s textem a přílohami
GET /council/documents	Usnesení a zápisy zastupitelstva se shrnutím
GET /council/documents/{id}	Jeden dokument zastupitelstva i s celým přepisem
GET /events	Chystané akce a otevírací dny sběrného dvora
GET /water-level	Poslední měření hladiny Bystré a povodňový stupeň
GET /water-level/history	Průběh hladiny za posledních N hodin
GET /webcams	Obecní webkamery a adresy jejich aktuálních snímků
GET /webcams/{slug}	Jedna webkamera i s časosběrnými videi posledních dní
GET /posts	Publikované články, po dvaceti na stránku
GET /posts/{slug}	Jeden článek i s celým textem

Adresy jsou relativní k adrese API výš.

Vyzkoušejte to

curl https://markvartice.net/api/v1/news?limit=3

Odpověď vypadá zhruba takhle:

{
  "data": [
    {
      "id": 412,
      "title": "Uzavírka silnice",
      "publishedAt": "2026-09-02T07:20:02+02:00",
      "excerpt": "Od pondělí bude…",
      …
    }
  ],
  "meta": {"count": 3}
}

Pravidla a formáty

Jen čtení. Všechno jsou požadavky GET. CORS je otevřený, takže API můžete volat i z JavaScriptu na vlastní stránce.
Obálka. Úspěšná odpověď je {"data": …}, výpisy mají navíc "meta" (počet položek, u článků stránkování). Chyba je {"error": {"code": …, "message": …}} se stejným HTTP kódem — 400 u špatného parametru, 404 u neexistující položky.
Čas je ve formátu ISO 8601 s posunem a vždy v českém čase (2026-09-02T07:20:02+02:00). Kalendářní den bez času je 2026-09-02.
Texty chodí jako zdrojový Markdown (content.markdown) i jako HTML (content.html). V HTML je případný kód ze zdroje zneškodněný, takže ho můžete vložit do vlastní stránky.
Limit je 10 požadavků za vteřinu z jedné adresy, nárazově až 50. Nad to dostanete odpověď 429 a máte chvíli počkat.
Cache. Odpovědi nesou Cache-Control a ETag. Když pošlete If-None-Match, nezměněná data přijdou jako prázdné 304. Novinky, desku a akce stahujeme z obce každých 15 minut a hlásič hladiny měří jednou za hodinu — častější dotazy nic nového nepřinesou.
Stabilita. Verze je v adrese (/v1). Pole mohou přibývat, existující se nepřejmenují ani nezmizí.

Na co si dát pozor

Úřední deska bez parametru vrací jen to, co dnes visí. Sejmuté dokumenty jsou za ?status=taken-down. Když API obce nemá přepsané znění dokumentu, je text automatické shrnutí — pak má content.source hodnotu generated a závazné je znění v příloze.
Přepisy a shrnutí dokumentů zastupitelstva jsou automatické. Vytvořil je jazykový model z originálních dokumentů obce a mohou obsahovat chyby. Rozhodující je originál, na který vede originalUrl. Datum zasedání model vyčetl z dokumentu, takže může chybět.
Hladina není výstražná služba. Když hlásič přestane posílat data, zůstane poslední hodnota — proto hlídejte stale a measuredAt. Závazné informace o povodních vydává ČHMÚ a povodňové orgány.
Snímky z webkamer leží přímo na kamerovém serveru a mění se zhruba každé dvě minuty. Častěji se na ně ptát nemá smysl.

Odkud data jsou

Novinky, úřední deska a akce pocházejí od obce Markvartice.
Usnesení a zápisy zastupitelstva jsou dokumenty obce; přepisy a shrnutí k nim vytváří tento web automaticky.
Měření hladiny poskytuje Portabo pod svobodnou licencí. Když data hladiny dál zveřejňujete, uveďte prosím zdroj — je i v odpovědi API (meta.source).
Články a webkamery jsou z tohoto webu.