Funkce

Vše, co potřebujete

Kompletní API českého kalendáře se jmeninami, svátky a českými názvy dnů a měsíců.

📅

366 dní se jmeninami

Úplný český kalendář jmenin včetně přestupného roku. Informace pro každý den v roce.

🇨🇿

České svátky

Všechny pevné svátky i pohyblivé velikonoční svátky. Velký pátek a Velikonoční pondělí počítáme automaticky.

🌍

České názvy

České názvy dnů a měsíců. Měsíce vracíme v prvním i druhém pádu.

⚡

REST & GraphQL

Vyberte si rozhraní, které vám vyhovuje. REST API s parametry nebo flexibilní dotazy GraphQL.

🚀

CDN cache

Rychlé odpovědi díky CDN cache. Data pro konkrétní datum se v CDN uchovávají až jeden rok.

🔒

Podpora CORS

Plná podpora CORS. Volejte API z prohlížeče, mobilní aplikace, IoT zařízení i chytré domácnosti.

Vyzkoušejte si

Živá ukázka API

Klikněte na endpoint a podívejte se na skutečnou odpověď API.

GET /api/day

Vyberte endpoint pro načtení odpovědi…

REST API

Endpointy

Jednoduché REST endpointy. Všechny odpovědi jsou ve formátu JSON.

Metoda	Endpoint	Popis
GET	`/api/day`	Informace o dnešním datu
GET	`/api/day/:date`	Konkrétní datum ve formátu YYYY-MM-DD
GET	`/api/day/:date/interval/:days`	Více po sobě jdoucích dnů od zadaného data
GET	`/api/week/:date`	7 dnů od zadaného data
GET	`/api/workdays?days=:days`	Příští pracovní dny bez víkendů a českých svátků
POST	`/api/graphql`	Endpoint GraphQL

Pro pracovní dny je days povinný parametr (1–365). Pomocí startDate=YYYY-MM-DD zvolíte výchozí datum; jinak se použije dnešek v UTC. Výchozí datum se nezapočítává. Odpověď obsahuje úplné objekty Day v { days: [...] }.

Odpověď: objekt Day

Day

date string ISO datum: "2024-12-24"

dayNumber string Den v měsíci: "24"

dayInWeek string Český název dne: "úterý"

monthNumber string Číslo měsíce: "12"

month.nominative string Český název měsíce v 1. pádě: "prosinec"

month.genitive string Český název měsíce v 2. pádě: "prosince"

year string Rok: "2024"

name string Jmeniny: "Adam a Eva"

isHoliday boolean Zda jde o státní nebo ostatní svátek

holidayName string? Název svátku nebo null

Integrace

Příklady použití

Začněte během chvilky v libovolném jazyce nebo frameworku.

        
        
        
        
      

# Získat dnešní jmeniny
curl https://svatkyapi.netlify.app/api/day

# Získat konkrétní datum
curl https://svatkyapi.netlify.app/api/day/2024-12-24

# Získat týden
curl https://svatkyapi.netlify.app/api/week/2024-12-24

# Získat 14 dnů od zadaného data
curl https://svatkyapi.netlify.app/api/day/2024-01-01/interval/14

# Příští 3 pracovní dny po čtvrtku; přeskočí sváteční pondělí
curl 'https://svatkyapi.netlify.app/api/workdays?days=3&startDate=2024-10-24'
      

// Načíst informace o dnešním datu
const response = await fetch('https://svatkyapi.netlify.app/api/day');
const today = await response.json();

console.log(today.name);        // "Milada"
console.log(today.dayInWeek);   // "sobota"
console.log(today.isHoliday);   // false

// Získat Štědrý den
const xmas = await fetch('https://svatkyapi.netlify.app/api/day/2024-12-24')
  .then(r => r.json());

console.log(xmas.holidayName);  // "Štědrý den"
      

import requests

# Získat informace o dnešním datu
response = requests.get('https://svatkyapi.netlify.app/api/day')
today = response.json()

print(today['name'])        # Jmeniny
print(today['dayInWeek'])   # Český název dne
print(today['isHoliday'])   # True/False

# Získat celý týden
week = requests.get('https://svatkyapi.netlify.app/api/week/2024-12-24').json()
for day in week['week']:
    print(f"{day['date']}: {day['name']}")
      

// Získat informace o dnešním datu
$response = file_get_contents('https://svatkyapi.netlify.app/api/day');
$today = json_decode($response, true);

echo $today['name'];        // Jmeniny
echo $today['dayInWeek'];   // Český název dne

// Získat Vánoce
$xmas = json_decode(
    file_get_contents('https://svatkyapi.netlify.app/api/day/2024-12-24'),
    true
);
echo $xmas['holidayName'];  // "Štědrý den"
      

GraphQL

GraphQL API

Flexibilní dotazy – vyžádejte si jen pole, která potřebujete.

query {
  day(date: "2024-12-24") {
    date
    name
    dayInWeek
    month {
      nominative
      genitive
    }
    isHoliday
    holidayName
  }
}

query {
  week(startDate: "2024-12-24") {
    week {
      date
      name
      isHoliday
      holidayName
    }
  }
}

# Vrátí 25., 29. a 30. října; 28. října je státní svátek
query {
  workdays(startDate: "2024-10-24", days: 3) {
    days {
      date
      dayInWeek
      name
    }
  }
}

curl -X POST https://svatkyapi.netlify.app/api/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ day(date: \"2024-12-24\") { date name isHoliday holidayName } }"
  }'

Férové používání

Limity požadavků

Zdarma pro všechny s limity pro férové používání. Aktuální využití zjistíte z hlaviček odpovědi.

60

Požadavků za minutu

1 rok

CDN cache (konkrétní datum)

<24h

CDN cache (dnes, do půlnoci)

Hlavičky odpovědi

X-RateLimit-Limit number Maximum požadavků za časové okno (60)

X-RateLimit-Remaining number Zbývající požadavky v aktuálním okně

Retry-After number Doba čekání v sekundách (jen při odpovědi 429)

API českého kalendářepro vývojáře