Datensets mit Feiertags-/Schulferienanteilen für jeden Tag eines Jahres.
Kapitel:
Ermöglicht Abfragen aggregierter Jahresdaten per ISO-Landescode oder ISO-3166-2 Regionencode.
Zum Abrufen der Daten verwenden Sie folgende URL. Achten Sie bitte auf Gross-Kleinschrift.
Mit den folgenden Variablen können Sie die Abfrage vervollständigen und die API-Ergebnisse steuern.
Parameter | Erläuterung | Beispiele |
---|---|---|
api_key erforderlich |
Ihr API-Key |
?api_key=abc-123-def-456 |
iso erforderlich |
ISO-Landeskürzel, 2-stellig, oder Regionencode nach ISO 3166-2 |
&iso=DE-BW |
year oder jahr |
Jahr der gewünschten Daten |
&year= 2025 |
class oder klasse |
Umfang der Daten Varianten: |
&klasse=5 |
charset | Die gewünschte Codierung der Antwort Varianten: |
&charset=iso-8859-1 |
format | Das gewünschte Ausgabeformat Varianten: |
&format=xml |
date_format | Das gewünschte Datumformat Varianten: |
&date_format=d.m.Y |
hl | Gewünschte Sprache der Ausgabe Varianten: |
&hl=en |
compact | Flag für kompakte Datenausgabe Varianten: |
&compact=0 |
filter | Filtereinstellung für Feiertage in Prozent Varianten: 0 = die Ausgabe enthält alle registrierten Feiertage 5 = Die Ausgabe enthält nur Feiertage, deren Anteil > 5% ist (= Standard) Die Filterung funktioniert mit Integerzahlen von 0 bis 100. |
&filter=0 |
Die Inhalte der API-Antworten ergeben sich aus:
- den von Ihnen abonnierten Daten (Länder, Feiertage, Schulferien, Kalenderjahre)
- den offiziell bekannten Daten der Gesetzgeber
- der Verfügbarkeit aufgrund unserer Recherchen (IST-Situation unserer Datenbank)
Beachten Sie bitte, dass die Ausgabe im CSV-Format abweicht.
Array | Erläuterung | Beispiel | ||||
---|---|---|---|---|---|---|
interface | Version des API | |||||
source: | href | URL zur Datenquelle (Website) | ||||
description | Bezeichnung der Datenquelle | |||||
copyright | href | URL zum Inhaber des Copyrights (Website) | ||||
description | Bezeichnung des Copyright-Inhabers | |||||
apiName | Identifikation des API | Data/Aggreg | ||||
apiStatus | description | Bezeichnung des API-Status. Für Varianten, siehe unter Fehlermeldungen | active | |||
date | Datum des Datenexports | 28.03.2024 | ||||
request: | iso | ISO-Landeskürzel, 2-stellig | DE | |||
year | Jahr der Daten in der Ausgabe | 2015 | ||||
charset | Schriftcodierung der Ausgabe | utf-8 | ||||
format | Datenformat der Ausgabe | json | ||||
date_format | Datumformat der Ausgabe | d.m.Y | ||||
hl | Sprache der Ausgabe, gemäss Anfrage | de | ||||
compact | Flag für kompakte Ausgabe, gemäss Anfrage | 1 | ||||
filter | Filterwert für Unterdrückung der Ausgabe von Feiertagen | 0 | ||||
results | status | description | Status der Ausgabe. Für Varianten, siehe unter Fehlermeldungen | ok | ||
location | description | Bezeichnung der geografischen Einheit | Deutschland | |||
type | Bezeichnung der Art der geografischen Einheit | Land | ||||
geoId | Geo-ID der geografischen Einheit. | 3059 | ||||
iso | ISO-Landeskürzel, 2-stellig | DE | ||||
iso-3166-2 | Regionencode nach ISO 3166-2 | |||||
calendar | die Kalenderausgabe | |||||
date | Datum des Kalenders | 2019-01-06 | ||||
total_population | Anzahl Einwohner im gewählten Gebiet | 81835000 | ||||
public_holiday_population | Anzahl Einwohner, betroffen von einem Feiertag | 25346076 | ||||
public_holiday_percent | Prozentualer Anteil der Einwohner, betroffen von einem Feiertag | 30.97217083155129 | ||||
public_holiday_description | Bezeichnung Feiertag | Heilige drei Könige | ||||
school_holiday_population | Anzahl Einwohner, betroffen von Schulferien | 81835000 | ||||
school_holiday_percent | Prozentualer Anteil der Einwohner, betroffen von Schulferien | 100 | ||||
school_holiday_description | Bezeichnung Schulferien | Weihnachtsferien | ||||
sum_population | Summe aus public_holiday_population und school_holiday_population | 81835000 | ||||
sum_percent | Summe aus public_holiday_percent und school_holiday_percent | 100 |
Art der Ausgabe | Fehlermeldung | Erläuterung |
---|---|---|
results: status: | ||
results: status: description | not subscribed | Sie haben die gewünschten Daten nicht abonniert. Wenden Sie sich bitte an unseren Support. |
results: status: description | unknown location | Das angeforderte ISO-Länderkürzel ist nicht bekannt. Prüfen Sie bitte den Parameter iso |
apiStatus | ||
apiStatus: description | invalid usage | Die Verwendung dieses API ist für Sie nicht freigeschaltet. Wenden Sie sich bitte an unseren Support. |
apiStatus: description | invalid key | Ungültiger API-Key. Prüfen Sie bitte Ihren API-Key. |
apiStatus: description | invalid referer | Ungültiger Zugriff. Links ab Webseiten (Front-Ends) sind nicht zulässig. Richten Sie Ihre Abfrage so ein, dass diese aus einem geschützten Back-End erfolgt. Wenden Sie sich allenfalls an unseren Support. |
apiStatus: description | inactive | Das API wurde für Sie noch nicht zur Benutzung freigeschaltet. Versuchen Sie es bitte zu einem späteren Zeitpunkt noch einmal. |
apiStatus: description | expired | Die Nutzungsdauer nach Vertrag ist abgelaufen. Wenden Sie sich für eine Vertragsverlängerung an unsere Administration. |
URL:
https://feiertagskalender.ch/api/Data/Aggreg/?api_key=YOUR_API_KEY&iso=DE&charset=ISO8859-1
Antwort in JSON / ISO8859-1:
{ "interface":"fcal API 2.0", "source":{ "href":"https://feiertagskalender.ch", "description":"feiertagskalender.ch" }, "copyright":{ "href":"https://psc.ch", "description":"psc Peter Schuetz Informatik-Dienstleistungen, CH Bern" }, "apiName":"Data/Aggreg", "apiStatus":{ "description":"active" }, "date":"2024-03-28", "request":{ "iso":"DE", "year":"2019", "charset":"iso8859-1", "format":"json", "date_format":"Y-m-d", "hl":"de", "compact":"1", "filter":"5" }, "results":{ "status":{ "description":"ok" }, "location":{ "description":"Deutschland", "type":"Land", "geoId":"3059", "iso":"DE", "iso-3166-2":"", "calendar":[ { "datum":"2019-01-01", "total_population":81835000, "public_holiday_population":81835000, "public_holiday_percent":100, "public_holiday_description":"Neujahr", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-02", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-03", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-04", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-05", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-06", "total_population":81835000, "public_holiday_population":25346076, "public_holiday_percent":30.972170831551292, "public_holiday_description":"Heilige drei Könige", "school_holiday_population":81835000, "school_holiday_percent":100, "school_holiday_description":"Weihnachtsferien", "sum_population":81835000, "sum_percent":100 }, { "datum":"2019-01-31", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":8528242, "school_holiday_percent":10.421264740025661, "school_holiday_description":"Semesterferien", "sum_population":8528242, "sum_percent":10.421264740025661 }, { "datum":"2019-02-01", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":10358673, "school_holiday_percent":12.657998411437649, "school_holiday_description":"Semesterferien", "sum_population":10358673, "sum_percent":12.657998411437649 }, { "datum":"2019-02-02", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":18064053, "school_holiday_percent":22.073749618134052, "school_holiday_description":"Winterferien", "sum_population":18064053, "sum_percent":22.073749618134052 }, { "datum":"2019-02-03", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":18064053, "school_holiday_percent":22.073749618134052, "school_holiday_description":"Winterferien", "sum_population":18064053, "sum_percent":22.073749618134052 }, { "datum":"2019-02-04", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":7705380, "school_holiday_percent":9.4157512066964024, "school_holiday_description":"Winterferien", "sum_population":7705380, "sum_percent":9.4157512066964024 }, { "datum":"2019-02-05", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":7705380, "school_holiday_percent":9.4157512066964024, "school_holiday_description":"Winterferien", "sum_population":7705380, "sum_percent":9.4157512066964024 }, { "datum":"2019-02-06", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":7705380, "school_holiday_percent":9.4157512066964024, "school_holiday_description":"Winterferien", "sum_population":7705380, "sum_percent":9.4157512066964024 }, { "datum":"2019-02-07", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":7705380, "school_holiday_percent":9.4157512066964024, "school_holiday_description":"Winterferien", "sum_population":7705380, "sum_percent":9.4157512066964024 }, { "datum":"2019-02-08", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":7705380, "school_holiday_percent":9.4157512066964024, "school_holiday_description":"Winterferien", "sum_population":7705380, "sum_percent":9.4157512066964024 }, { "datum":"2019-02-09", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":12099760, "school_holiday_percent":14.785556302315635, "school_holiday_description":"Winterferien", "sum_population":12099760, "sum_percent":14.785556302315635 }, { "datum":"2019-02-10", "total_population":81835000, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":"", "school_holiday_population":12099760, "school_holiday_percent":14.785556302315635, "school_holiday_description":"Winterferien", "sum_population":12099760, "sum_percent":14.785556302315635 }, ... ] } } }
URL:
https://feiertagskalender.ch/api/Data/Aggreg/?api_key=YOUR_API_KEY&iso=DE&charset=ISO8859-1&format=xml
Antwort des APIs:
<fcal_api> <interface>fcal API 2.0</interface> <source> <href>https://feiertagskalender.ch</href> <description>feiertagskalender.ch</description> </source> <copyright> <href>https://psc.ch</href> <description>psc Peter Schuetz Informatik-Dienstleistungen, CH Bern</description> </copyright> <apiStatus> <description>active</description> </apiStatus> <apiName>Data/Aggreg</apiName> <date>2024-03-28</date> <request> <iso>DE</iso> <year>2019</year> <charset>iso8859-1</charset> <format>xml</format> <date_format>Y-m-d</date_format> <hl>de</hl> <compact>1</compact> <filter>5</filter> </request> <results> <status> <description>ok</description> </status> <location> <description>Deutschland</description> <type>Land</type> <geoId>3059</geoId> <iso>DE</iso> <iso-3166-2/> <events> <day> <datum>2019-01-01</datum> <total_population>81835000</total_population> <public_holiday_population>81835000</public_holiday_population> <public_holiday_percent>100</public_holiday_percent> <public_holiday_description>Neujahr</public_holiday_description> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-02</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-03</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-04</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-05</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-06</datum> <total_population>81835000</total_population> <public_holiday_population>25346076</public_holiday_population> <public_holiday_percent>30.972170831551</public_holiday_percent> <public_holiday_description>Heilige drei Könige</public_holiday_description> <school_holiday_population>81835000</school_holiday_population> <school_holiday_percent>100</school_holiday_percent> <school_holiday_description>Weihnachtsferien</school_holiday_description> <sum_population>81835000</sum_population> <sum_percent>100</sum_percent> </day> <day> <datum>2019-01-31</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>8528242</school_holiday_population> <school_holiday_percent>10.421264740026</school_holiday_percent> <school_holiday_description>Semesterferien</school_holiday_description> <sum_population>8528242</sum_population> <sum_percent>10.421264740026</sum_percent> </day> <day> <datum>2019-02-01</datum> <total_population>81835000</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description/> <school_holiday_population>10358673</school_holiday_population> <school_holiday_percent>12.657998411438</school_holiday_percent> <school_holiday_description>Semesterferien</school_holiday_description> <sum_population>10358673</sum_population> <sum_percent>12.657998411438</sum_percent> </day> ... </events> </location> </results> </fcal_api>
URL:
https://feiertagskalender.ch/api/Data/Aggreg/?api_key=YOUR_API_KEY&iso=DE&format=csv
Antwort in CSV / UTF-8:
"location";"geoId";"iso";"iso-3166-2";"date";"total_population";"public_holiday_population";"public_holiday_percent";"public_holiday_description";"school_holiday_population";"school_holiday_percent";"school_holiday_description";"sum_population";"sum_percent" "Deutschland";"3059";"DE";"";"2019-01-01";"81835000";"81835000";"100";"Neujahr";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-02";"81835000";"0";"0";"";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-03";"81835000";"0";"0";"";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-04";"81835000";"0";"0";"";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-05";"81835000";"0";"0";"";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-06";"81835000";"25346076";"30.972170831551";"Heilige drei Könige";"81835000";"100";"Weihnachtsferien";"81835000";"100" "Deutschland";"3059";"DE";"";"2019-01-31";"81835000";"0";"0";"";"8528242";"10.421264740026";"Semesterferien";"8528242";"10.421264740026" "Deutschland";"3059";"DE";"";"2019-02-01";"81835000";"0";"0";"";"10358673";"12.657998411438";"Semesterferien";"10358673";"12.657998411438" "Deutschland";"3059";"DE";"";"2019-02-02";"81835000";"0";"0";"";"18064053";"22.073749618134";"Winterferien";"18064053";"22.073749618134" "Deutschland";"3059";"DE";"";"2019-02-03";"81835000";"0";"0";"";"18064053";"22.073749618134";"Winterferien";"18064053";"22.073749618134" "Deutschland";"3059";"DE";"";"2019-02-04";"81835000";"0";"0";"";"7705380";"9.4157512066964";"Winterferien";"7705380";"9.4157512066964" "Deutschland";"3059";"DE";"";"2019-02-05";"81835000";"0";"0";"";"7705380";"9.4157512066964";"Winterferien";"7705380";"9.4157512066964" "Deutschland";"3059";"DE";"";"2019-02-06";"81835000";"0";"0";"";"7705380";"9.4157512066964";"Winterferien";"7705380";"9.4157512066964" "Deutschland";"3059";"DE";"";"2019-02-07";"81835000";"0";"0";"";"7705380";"9.4157512066964";"Winterferien";"7705380";"9.4157512066964" "Deutschland";"3059";"DE";"";"2019-02-08";"81835000";"0";"0";"";"7705380";"9.4157512066964";"Winterferien";"7705380";"9.4157512066964" "Deutschland";"3059";"DE";"";"2019-02-09";"81835000";"0";"0";"";"12099760";"14.785556302316";"Winterferien";"12099760";"14.785556302316" "Deutschland";"3059";"DE";"";"2019-02-10";"81835000";"0";"0";"";"12099760";"14.785556302316";"Winterferien";"12099760";"14.785556302316" "Deutschland";"3059";"DE";"";"2019-02-11";"81835000";"0";"0";"";"6003981";"7.3366909024256";"Winterferien";"6003981";"7.3366909024256" "Deutschland";"3059";"DE";"";"2019-02-12";"81835000";"0";"0";"";"6003981";"7.3366909024256";"Winterferien";"6003981";"7.3366909024256" "Deutschland";"3059";"DE";"";"2019-02-13";"81835000";"0";"0";"";"6003981";"7.3366909024256";"Winterferien";"6003981";"7.3366909024256" "Deutschland";"3059";"DE";"";"2019-02-14";"81835000";"81835000";"100";"Valentinstag";"6003981";"7.3366909024256";"Winterferien";"81835000";"100" ...