---
title: "OpenHolidays API"
description: "OpenHolidays API în TapHome: sărbători legale și vacanțe școlare din peste 35 de țări prin HTTP — programe de încălzire, iluminat și alarmă."
url: "https://taphome.com/ro/compatibility/openholidays/"
language: ro
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","other","rest-api","holiday-detection","scheduling"]
  questions: ["Cum integrez OpenHolidays API cu TapHome?","Cum detectează TapHome automat sărbătorile legale?","Cum configurez codurile de țară și de regiune pentru OpenHolidays în TapHome?","De ce dispozitivul pentru sărbători legale afișează rezultate incorecte?","Care este diferența dintre IsPublicHoliday și IsSchoolHoliday în TapHome?","Poate TapHome să ajusteze programele de încălzire în funcție de sărbători?"]
---

# OpenHolidays API

Comunicație: Packet Parser → HTTP

- [Site-ul OpenHolidays API](https://www.openholidaysapi.org)

## Ghid de integrare

OpenHolidays API este un REST API gratuit, open source, care oferă date despre sărbătorile legale și vacanțele școlare pentru peste 35 de țări. TapHome se conectează la acest serviciu cloud prin HTTPS, folosind un șablon PacketParser HTTP — nu este necesară autentificarea sau o cheie API.

Șablonul oferă trei dispozitive binare doar pentru citire: unul pentru sărbătorile legale, unul pentru vacanțele școlare și unul pentru weekend. Le puteți folosi în smart rules TapHome pentru a ajusta programele de încălzire, modurile de alarmă, scenele de iluminat sau orice altă automatizare în funcție de faptul că ziua de azi este sau nu zi lucrătoare.

Șablonul a fost creat de ToBo, un colaborator din comunitate.

## Configurare

La importul șablonului sunt necesari doi parametri:

- **Country** — codul de țară ISO 3166-1 alpha-2 (de ex. `SK` pentru Slovacia, `DE` pentru Germania, `CZ` pentru Cehia). Lista completă a țărilor suportate este disponibilă la `https://openholidaysapi.org/Countries`.
- **Region** — codul subdiviziunii ISO 3166-2 (de ex. `SK-BC` pentru regiunea Banska Bystrica, `DE-BY` pentru Bavaria). Lista subdiviziunilor unei țări este disponibilă la `https://openholidaysapi.org/Subdivisions?countryIsoCode={CountryCode}`.

Ambii parametri se salvează în TapHome ca variabile ale modulului și pot fi modificați după import, fără reimportarea șablonului.

> [!TIP]
> Multe țări au sărbători legale specifice regiunilor. Dacă detectarea sărbătorilor pare incorectă, verificați dacă codul subdiviziunii corespunde regiunii corecte — nu doar codul țării.

## Funcțiile dispozitivului

### Detectarea sărbătorilor legale

Dispozitivul Sărbătoare legală interoghează endpointul `GET /PublicHolidays` o dată pe oră. Trimite data de azi împreună cu codurile de țară și de regiune configurate. Dacă API-ul returnează o sărbătoare pentru data respectivă, dispozitivul afișează **Da**; altfel afișează **Nu**.

### Detectarea vacanțelor școlare

Dispozitivul Vacanță școlară funcționează la fel, dar interoghează endpointul `GET /SchoolHolidays`. Detectează dacă ziua de azi se încadrează într-o perioadă de vacanță școlară pentru țara și regiunea configurate.

> [!NOTE]
> Disponibilitatea datelor despre vacanțele școlare diferă de la o țară la alta. Unele țări au o acoperire limitată a subdiviziunilor — verificați în documentația API dacă regiunea dvs. este suportată.

### Detectarea weekendului

Dispozitivul Weekend nu apelează API-ul. Folosește funcția locală TapHome `NOW().DAYOFWEEK` pentru a determina dacă ziua de azi este sâmbătă (ziua 6) sau duminică (ziua 0). Acest dispozitiv funcționează independent de API și nu necesită conexiune la internet.

### Funcții suplimentare

OpenHolidays API expune și endpointuri pentru interogarea sărbătorilor dintr-o anumită dată în toate țările (`/PublicHolidaysByDate`, `/SchoolHolidaysByDate`), pentru listarea țărilor și a subdiviziunilor regionale suportate și pentru obținerea statisticilor despre perioadele acoperite de datele disponibile. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Detectarea sărbătorilor returnează rezultate incorecte

1. Verificați dacă codul Country este corect — folosiți endpointul `/Countries` pentru a verifica lista țărilor suportate
2. Verificați codul Region (subdiviziunea) — unele sărbători legale sunt specifice regiunii și nu apar cu un cod de subdiviziune greșit
3. Verificați API-ul direct în browser: `https://openholidaysapi.org/PublicHolidays?countryIsoCode=SK&subdivisionCode=SK-BC&validFrom=2026-01-01&validTo=2026-01-01` — înlocuiți data și codurile cu valorile dvs.
4. Dacă API-ul returnează un tablou gol `[]` pentru o dată care ar trebui să fie sărbătoare, este posibil ca datele să nu fie încă disponibile pentru țara sau anul respectiv

### Dispozitivul afișează eroare (NaN)

Dacă API-ul nu este accesibil (problemă de rețea, eroare DNS sau indisponibilitatea API-ului), șablonul returnează NaN, cu codul de stare HTTP în mesajul de eroare. OpenHolidays API este un proiect al comunității, fără SLA — verificați disponibilitatea actuală pe pagina de stare `https://openpotato.github.io/uptime/`.

> [!WARNING]
> OpenHolidays API este un proiect de date deschise întreținut de comunitate. Deși până acum a funcționat fiabil, disponibilitatea sa nu este garantată. Pentru automatizările critice, luați în considerare adăugarea unui smart rule de rezervă care tratează corect starea de eroare.

## Dispozitive disponibile 3

Aceste dispozitive apar în TapHome după import.

OpenHolidays Modul

Variabile personalizate

`Country` (string) Codul de țară ISO 3166-1 alpha-2 (de ex. SK, DE, CZ)

Full list at openholidaysapi.org/Countries

`Region` (string) Codul subdiviziunii ISO 3166-2 (de ex. SK-BC, DE-BY)

List at openholidaysapi.org/Subdivisions?countryIsoCode={CountryCode}

Sărbătoare legală Comutator Doar citire

Interoghează OpenHolidays API o dată pe oră — Da dacă ziua de azi este sărbătoare legală în țara și regiunea configurate, altfel Nu

boolean json\_path

Valori / Stări: Yes · No

Citirea stării comutatorului

```taphome
var dt := NOW();
var date := dt.YEAR + "-" + dt.MONTH + "-" + dt.DAY;
var req:= "PublicHolidays?countryIsoCode=" + Country + "&subdivisionCode=" + Region + "&validFrom="+date + "&validTo="+date;
var response := SENDHTTPREQUEST(req);

if response.IsSuccess
  var content := response.Content;
  var isHoliday := PARSEJSON( content, "[0].temporalScope", 1);
  if isHoliday != null
    return(1);
  else
    return(0);
  end
else
  adderror(response.StatusCode + " (" + response.ReasonPhrase + ")");
  return(NaN);
end
```

Vacanță școlară Comutator Doar citire

Interoghează OpenHolidays API o dată pe oră — Da dacă ziua de azi se încadrează într-o perioadă de vacanță școlară în țara și regiunea configurate, altfel Nu

boolean json\_path

Valori / Stări: Yes · No

Citirea stării comutatorului

```taphome
var dt := NOW();
var date := dt.YEAR + "-" + dt.MONTH + "-" + dt.DAY;
var req:= "SchoolHolidays?countryIsoCode=" + Country + "&subdivisionCode=" + Region + "&validFrom="+date + "&validTo="+date;
var response := SENDHTTPREQUEST(req);

if response.IsSuccess
  var content := response.Content;
  var isHoliday := PARSEJSON( content, "[0].temporalScope", 1);
  if isHoliday != null
    return(1);
  else
    return(0);
  end
else
  adderror(response.StatusCode + " (" + response.ReasonPhrase + ")");
  return(NaN);
end
```

Weekend Comutator Doar citire

Calcul local — Da sâmbăta și duminica, Nu de luni până vineri. Nu folosește API-ul.

boolean

Valori / Stări: Yes · No

Citirea stării comutatorului

```taphome
var dt := NOW();
return(dt.DAYOFWEEK = 0 or dt.DAYOFWEEK = 6);
```

**Conexiune:** Packet Parser → HTTP

Îmbunătățiri posibile (7)

- Public Holidays By Date — Returns all public holidays across all countries for a single date — alternative to country-scoped query
- School Holidays By Date — Returns all school holidays across all countries for a single date
- Supported Countries — List of 35+ supported countries — useful for configuration but not a sensor
- Regional Subdivisions — List of regional divisions for a country — useful for configuration
- Public Holiday Data Range — Date range of available public holiday data for a country
- School Holiday Data Range — Date range of available school holiday data for a country
- Holiday Groups — Non-geographic holiday groupings (language zones, school types) for a country

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit |
|------------------------|----------|
| Country                | `SK`     |
| Region                 | `SK-BC`  |

## Surse

- OpenHolidays API Reference (OpenAPI)
  
  [openholidaysapi.org](https://openholidaysapi.org/swagger/v1/swagger.json) 2026-03-28
- OpenHolidays API — Website Overview
  
  [www.openholidaysapi.org](https://www.openholidaysapi.org/en/api/) 2026-03-28
- OpenHolidays API — GitHub Repository
  
  [github.com](https://github.com/openpotato/openholidaysapi) 2026-03-28

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

