Deutsche Feiertage per JSON-Webservice (API)

Wir haben im Internet lange nach einer passenden Lösung gesucht, in allen Anwendungen schnell und einfach alle deutschen Feiertage abfragen zu können. Leider gab es solche Services in der Vergangenheit, diese scheinen nun aber alle nicht mehr zu existierten.

Also haben wir selber einen kleinen Webservice auf JSON-Basis geschrieben.

Was kostet der Webservice?

Nichts. Er ist und bleibt kostenlos. Auch für kommerzielle Anwendungen.
Wir freuen uns aber über eine Spende:




 

Grundlegende Nutzung

Die Nutzung des Webservices erfolgt durch einen Aufruf von

https://feiertage-api.de/api/?jahr=2019

Alle Parameter (weitere siehe unten) sind einfache GET-Parameter, die der URL angehangen werden.

Nutzung per JSONP

Für die Nutzung des Webservices mittels JSONP, verwenden Sie den Parameter „callback“. Die Rückgabe wird sodann in einen JSONP-Funktionsaufruf eingebettet.

Beispiel:

https://feiertage-api.de/api/?jahr=2014&callback=test123

Rückgabe:
test123(JSON-RUECKGABE...);

Nutzung per PHP

Für die Nutzung des Webservices mittels PHP haben wir eine Beispiel-Connector-Classe bereitgestellt, die jeder benutzen kann.

Sie findet sich hier.

Hinweise zur Rückgabe

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 in unserem Tool enthalten.

Welche Parameter gibt es?

jahr Pflichtparameter, der ein beliebiges Jahr in Zahlenform annehmen kann. z.B. 2014
nur_land Wenn gesetzt, dann werden nur Feiertage des gewählten Bundeslandes angezeigt.
Mögliche Werte: (siehe Tabelle unten)
nur_daten Wenn gesetzt (wert egal, z.B. auf 1), dann werden keine Bundeslandspezifischen informationen ausgegeben, sondern alle deutschen Feiertage samt Datum ausgegeben.
callback Wenn gesetzt, dann wird die Ausgabe in eine JSONP-Funktion eingebettet.

Abfrage einzelner Bundesländer (Bundesland-Abkürzungen)

In der nachfolgenden Tabelle findet man alle Bundesland-Kürzel, mit welchen man die Abfrage auf einzelne Bundesländer einschränken kann.

Zusätzlich zu den unten stehenden Abkürzungen kann man auch „NATIONAL“ als Abkürzung benutzen. Dann erhält man nur jene Feiertage, die in allen Bundesländern als Feiertag anerkannt sind.

Beispiel (Nordrhein-Westfalen):

https://feiertage-api.de/api/?jahr=2016&nur_land=NW

Coat of arms of Baden-Württemberg (lesser).svg
BW
Bayern Wappen.svg
BY
Coat of arms of Berlin.svg
BE
Brandenburg Wappen.svg
BB
Bremen Wappen(Mittel).svg
HB
Coat of arms of Hamburg.svg
HH
Coat of arms of Hesse.svg
HE
Coat of arms of Mecklenburg-Western Pomerania (great).svg
MV
Baden-Württemberg Bayern Berlin Brandenburg Bremen Hamburg Hessen Mecklenburg-Vorpommern
Coat of arms of Lower Saxony.svg
NI
Coat of arms of North Rhine-Westfalia.svg
NW
Coat of arms of Rhineland-Palatinate.svg
RP
Wappen des Saarlands.svg
SL
Coat of arms of Saxony.svg
SN
Wappen Sachsen-Anhalt.svg
ST
Coat of arms of Schleswig-Holstein.svg
SH
Coat of arms of Thuringia.svg
TH
Niedersachsen Nordrhein-Westfalen Rheinland Pfalz Saarland Sachsen Sachen-Anhalt Schleswig Holstein Thüringen

Quelle der Bundesland-Wappen: wikipedia.de