Svátky REST API — BuresIndustries

Živá ukázka

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 a Velký pátek od 2016).

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ždé celé hodiny.

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 API

Endpoint /svatky/api/graphql přijímá POST s JSON tělem nebo GET s query parametrem. Stejný rate limit jako REST (100 dotazů/hod na IP). 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 (Query)

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

Příklad — 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 } }"}'

Příklad — 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);

Živý dotaz — vyzkoušej GraphQL

POST /svatky/api/graphql

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.

Svátky API

Rychle

Kompletní

Zdarma