https://github.com/bundesapi/feiertage-api
API for getting holidays of Germany by state. See: https://feiertage-api.de/
https://github.com/bundesapi/feiertage-api
Last synced: 21 days ago
JSON representation
API for getting holidays of Germany by state. See: https://feiertage-api.de/
- Host: GitHub
- URL: https://github.com/bundesapi/feiertage-api
- Owner: bundesAPI
- Created: 2022-05-20T16:06:12.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T12:13:07.000Z (11 months ago)
- Last Synced: 2024-05-22T12:17:16.933Z (11 months ago)
- Language: Python
- Homepage: http://feiertage.api.bund.dev/
- Size: 134 KB
- Stars: 45
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[[DE]](README.md)/[[EN]](README_en.md)
# Feiertage API
Der [Feiertage Webservice](https://feiertage-api.de/) von [Julian Richter](https://www.paypal.com/donate?token=-JAL84u4LbrgiDzVqvJqWOnqhusn30r_FwEBT65n0kqlZd7FTRidVBPL9kjFsKIOsZaqFTEm0jz6_JVm) bietet den Zugriff auf deutsche Feiertage im JSON-Format.
Das Tool basiert auf den Angaben von http://de.wikipedia.org/wiki/Feiertage_in_Deutschland. Auf der Wikipedia-Seite ist ersichtlich, dass manche Feiertage nicht im ganzen Bundesgebiet, sondern auf Bundeslandebene gelten. Die dort genannten Informationen sind im Tool hinterlegt.
Ebenso kann es spezielle Anmerkungen zu bestimmten Feiertagen geben (siehe Wikipedia-Seite). Auch diese Hinweise sind im Tool enthalten.
*Hinweis:* Für die Nutzung des Webservices mittels PHP haben die Ersteller eine Beispiel-Connector-Classe bereitgestellt, die jeder benutzen kann. Sie findet sich [hier](https://feiertage-api.de/api/Connector.php.txt).
## Anfragen
Die Nutzung des Webservices erfolgt durch einen GET-request an folgende URL:
**URL:** https://feiertage-api.de/api/
Alle Parameter sind einfache GET-Parameter, die der URL angehängt werden.
### Filter
**Parameter:** *jahr*
Pflichtparameter, der ein beliebiges Jahr in Zahlenform annehmen kann, z.B. 2014.
**Parameter:** *nur_land*
Wenn gesetzt, dann werden nur Feiertage des gewählten Bundeslandes angezeigt.
Mögliche Werte:
- NATIONAL
- BW
- BY
- BE
- BB
- HB
- HH
- HE
- MV
- NI
- NW
- RP
- SL
- SN
- ST
- SH
- TH
NATIONAL=Bundesweit anerkannte Feiertage, BW=Baden-Württemberg, BY=Bayern, BE=Berlin, BB=Brandenburg, HB=Bremen, HH=Hamburg, HE=Hessen, MV=Mecklenburg-Vorpommern, NI=Niedersachsen, NW=Nordrhei-Westfalen, RP=Rheinland-Pfalz, SL=Saarland, SN=Sachsen, ST=Sachsen-Anhalt, SH=Schleswig-Holstein, TH=Thüringen.
**Parameter:** *nur_daten*
Wenn gesetzt (Wert egal, z.B. auf 1), dann werden keine bundeslandspezifischen informationen ausgegeben, sondern alle deutschen Feiertage samt Datum ausgegeben.
**Parameter:** *callback*
Wenn gesetzt, dann wird die Ausgabe in eine JSONP-Funktion eingebettet.
### Beispiel
```bash
feiertage=$(curl -m 60 'https://feiertage-api.de/api/?jahr=2022&nur_land=BY')
```