API

Svátky API

REST i GraphQL endpoint pro české jmeniny, státní svátky a informace o libovolném datu. Zdarma, bez registrace. Rate limit 100 dotazů za hodinu na IP adresu.

Vyzkoušet GraphQL Dokumentace

Živá ukázka

Klikni na datum, odpověď přijde z ostrého endpointu.

GET /svatky/api/

Načítám…

Endpointy

Metoda	Endpoint	Popis
GET	`/svatky/api/`	Informace o dnešním dni
GET	`/svatky/api/:date`	Konkrétní datum (YYYY-MM-DD)

Struktura odpovědi

Pole	Typ	Popis
`date`	`string`	Datum ve formátu YYYY-MM-DD
`dayNumber`	`int`	Den v měsíci
`dayInWeek`	`string`	Den v týdnu česky
`monthNumber`	`int`	Číslo měsíce
`month.nominative`	`string`	Název měsíce v 1. pádě
`month.genitive`	`string`	Název měsíce v 2. pádě
`year`	`int`	Rok
`name`	`string`	Jméno, které má svátek
`isHoliday`	`boolean`	Je státní svátek?
`holidayName`	`string\|null`	Název státního svátku
`shopsClosed`	`boolean`	Musí být velké prodejny uzavřeny? (zákon č. 223/2016 Sb.)
`shopsClosedNote`	`string\|null`	Popis zavírací povinnosti včetně času (např. „po 12:00“ pro Štědrý den)

shopsClosed platí pro prodejny nad 200 m² a velkoobchody. Maloobchod pod 200 m² zavírat nemusí. Zákon platí od 1. 1. 2017 (Vánoce od 2016) a vztahuje se jen na 1. 1., Velikonoční pondělí, 8. 5., 28. 9., 28. 10., 24. 12. (od 12:00), 25. 12. a 26. 12. Na ostatní státní svátky (1. 5., 5. 7., 6. 7., Velký pátek, 17. 11.) se zákaz nevztahuje.

Omezení použití

Hlavička	Popis
`X-RateLimit-Limit`	Maximální počet dotazů za hodinu (výchozí: 100)
`X-RateLimit-Remaining`	Zbývající dotazy v aktuálním hodinovém okně

Při překročení limitu API vrací HTTP 429. Limit je per-IP a resetuje se každou celou hodinu.

Příklady použití

cURL

curl https://buresindustries.cz/svatky/api/
curl https://buresindustries.cz/svatky/api/2024-12-24

JavaScript

const res = await fetch('https://buresindustries.cz/svatky/api/');
const data = await res.json();
console.log(data.name);

PHP

$json = file_get_contents('https://buresindustries.cz/svatky/api/');
$data = json_decode($json);
echo $data->name;

Python

import requests
data = requests.get('https://buresindustries.cz/svatky/api/').json()
print(data['name'])

GraphQL

Endpoint /svatky/api/graphql přijímá POST s JSON tělem nebo GET s query parametrem. Stejný rate limit jako REST. Podporuje introspekci schématu.

Metoda	Endpoint	Popis
POST	`/svatky/api/graphql`	GraphQL dotaz (JSON body: `{"query":"…"}`)
GET	`/svatky/api/graphql?query=…`	GraphQL dotaz jako URL parametr

Dostupné dotazy

Dotaz	Parametry	Popis
`today`	—	Dnešní den
`day`	`date: String` (YYYY-MM-DD, výchozí: dnes)	Konkrétní den
`week`	`date: String` (výchozí: dnes)	7 dní od zadaného data
`days`	`date: String`, `count: Int` (1–366, výchozí: 7)	N po sobě jdoucích dní

Typ Day

Pole	Typ	Popis
`date`	`String`	YYYY-MM-DD
`dayNumber`	`Int`	Den v měsíci
`dayInWeek`	`String`	Den v týdnu česky
`monthNumber`	`Int`	Číslo měsíce
`month`	`Month`	Název měsíce (nominativ + genitiv)
`year`	`String`	Rok
`name`	`String`	Jméno svátku
`isHoliday`	`Boolean`	Státní svátek?
`holidayName`	`String`	Název státního svátku
`shopsClosed`	`Boolean`	Zavřené prodejny nad 200 m²?
`shopsClosedNote`	`String`	Poznámka k zavírací povinnosti

Dnešní den (curl)

curl -X POST https://buresindustries.cz/svatky/api/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ today { date name isHoliday holidayName shopsClosed } }"}'

7 dní od Vánoc (curl)

curl -X POST https://buresindustries.cz/svatky/api/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ days(date: \"2025-12-24\", count: 7) { date name isHoliday shopsClosed } }"}'

JavaScript (fetch)

const res = await fetch('https://buresindustries.cz/svatky/api/graphql', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    query: `{ today { date name dayInWeek isHoliday holidayName month { nominative } } }`
  })
});
const { data } = await res.json();
console.log(data.today);

Vyzkoušej dotaz

POST /svatky/api/graphql

GraphQL dotaz

Zadej dotaz a klikni Spustit.

Rychle

Minimální odezva, žádné zbytečné zpracování.

Kompletní

Jmeniny, svátky, Velikonoce, den v týdnu.

Zdarma

Žádný API klíč, žádná registrace. Rate limit 100 dotazů/hod na IP.