Jahresdaten aller Gemeinden in Schweden (inkl. Gemeindecodes).
Kapitel:
Ermöglicht Abfragen für Schweden. Gibt alle Gemeinden (inkl. SCB-Code) mit deren Feiertagen und Schulferien aus, vom 1.01. - 31.12. eines Jahres.
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 |
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 |
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/Country/SE | ||||
apiStatus | description | Bezeichnung des API-Status. Für Varianten, siehe unter Fehlermeldungen | active | |||
date | Datum des Datenexports | 04.05.2024 | ||||
request: | iso | ISO-Landeskürzel, 2-stellig | SE | |||
year | Jahr der Daten in der Ausgabe | 2015 | ||||
class | Klasse der Abfrage (betrifft den Umfang der Daten) | 4 | ||||
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 | ||||
results | status | description | Status der Ausgabe. Für Varianten, siehe unter Fehlermeldungen | ok | ||
locations | location | description | Bezeichnung der geografischen Einheit | Karlshamn | ||
type | Bezeichnung der Art der geografischen Einheit | Gemeinde | ||||
geoId | Geo-ID der geografischen Einheit. | 4849 | ||||
scb | SCB-Code (Statistiska centralbyrån) | 1082 | ||||
iso | ISO-Landeskürzel, 2-stellig | SE | ||||
iso-3166-2 | Regionencode nach ISO 3166-2 | SE-K | ||||
note | Besondere Hinweise | |||||
events | Die Kalenderevents | |||||
description | Bezeichnung des Feiertags, oder der Schulferien | Neujahr | ||||
id | Eindeutige ID des Events. Feiertage haben jedes Jahr dieselbe ID. Schulferien haben alle ihre eigenen IDs. |
1 | ||||
dateStart | Datum Beginn des Events | 01.01.2015 | ||||
dateEnd | Datum Ende des Events | 01.01.2015 | ||||
class | Klasse des Events: 0 = Schulferien 1 = gesetzlich anerkannter Feiertag 2 = Den Sonntagen gleichgestellter Feiertag 3 = halber, gesetzlich anerkannter Feiertag (meist ab Mittag) 4 = gesetzlich nicht anerkannter Feiertag (Geschäfte, Schulen, Verwaltungen meist geschlossen), Bankenfeiertag; im Sinne des Europäischen Übereinkommens über die Berechnung der Fristen wird dieser Tag wie ein gesetzlicher Feiertag behandelt (Art. 5). 5 = Ereignistag # = nur teilweise gültig |
2 | ||||
percent | Umfang der betroffenen Einwohner / Schulklassen in Prozent | 100 | ||||
prov | Flag für provisorisch festgelegte Daten 0 = definitiv 1 = provisorisch |
0 | ||||
note | besondere hinweise |
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. |
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/Country/CH/?api_key=YOUR_API_KEY&jahr=2023
Antwort des APIs:
{ "interface": "fcal API 2.01", "source": { "href": "https://feiertagskalender.ch", "description": "feiertagskalender.ch" }, "copyright": { "href": "https://psc.ch", "description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Bern" }, "apiName": "Data/Country/SE", "apiStatus": { "description": "active" }, "date": "2023-06-16", "request": { "iso": "SE", "year": "2023", "class": "4", "charset": "utf-8", "format": "json", "date_format": "Y-m-d", "hl": "de" }, "results": { "status": { "description": "ok" }, "locations": [ { "description": "Ale", "type": "Gemeinde", "geoId": "4744", "scb": "1440", "iso": "SE", "iso-3166-2": "SE-O", "note": "", "events": [ { "description": "Neujahr", "id": "1", "dateStart": "2023-01-01", "dateEnd": "2023-01-01", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Heilige drei Könige", "id": "4", "dateStart": "2023-01-06", "dateEnd": "2023-01-06", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Karfreitag", "id": "17", "dateStart": "2023-04-07", "dateEnd": "2023-04-07", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Ostern", "id": "18", "dateStart": "2023-04-09", "dateEnd": "2023-04-09", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Ostermontag", "id": "19", "dateStart": "2023-04-10", "dateEnd": "2023-04-10", "class": "1", "percent": "100", "prov": "0", "note": null }, { ... } ] }, { "description": "Alingsås", "type": "Gemeinde", "geoId": "4745", "scb": "1489", "iso": "SE", "iso-3166-2": "SE-O", "note": "", "events": [ { ... }] }] } }
URL:
https://feiertagskalender.ch/api/Data/Country/CH/?api_key=YOUR_API_KEY&jahr=2023&charset=ISO-8859-1&date_format=Y-m-d&format=xml
Antwort des APIs:
<fcal_api> <interface>fcal API 2.01</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/Country/SE</apiName> <date>2023-06-16</date> <request> <iso>SE</iso> <year>2023</year> <class>4</class> <charset>ISO-8859-1</charset> <format>xml</format> <date_format>Y-m-d</date_format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <locations> <location> <description>Ale</description> <type>Gemeinde</type> <geoId>4744</geoId> <scb>1440</scb> <iso>SE</iso> <iso-3166-2>SE-O</iso-3166-2> <note/> <events> <event> <description>Neujahr</description> <id>1</id> <dateStart>2023-01-01</dateStart> <dateEnd>2023-01-01</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note/> </event> <event> <description>Heilige drei Könige</description> <id>4</id> <dateStart>2023-01-06</dateStart> <dateEnd>2023-01-06</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note/> </event> <event> <description>Karfreitag</description> <id>17</id> <dateStart>2023-04-07</dateStart> <dateEnd>2023-04-07</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note/> </event> <event> <description>Ostern</description> <id>18</id> <dateStart>2023-04-09</dateStart> <dateEnd>2023-04-09</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note/> </event> <event> </event> </events> </location> <location> <description>Alingsås</description> <type>Gemeinde</type> <geoId>4745</geoId> <scb>1489</scb> <iso>SE</iso> <iso-3166-2>SE-O</iso-3166-2> <note/> <events> ... </events> </location> </locations> </results> </fcal_api>
Aufruf:
https://feiertagskalender.ch/api/Data/Country/CE/?api_key=YOUR_API_KEY&charset=iso-8859-1&format=csv&jahr=2023
Antwort des APIs:
"location";"geoId";"scb";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note" "Ale";"4744";"1440";"SE";"SE-O";"Neujahr";"1";"2023-01-01";"2023-01-01";"1";"100";"0";"" "Ale";"4744";"1440";"SE";"SE-O";"Heilige drei Könige";"4";"2023-01-06";"2023-01-06";"1";"100";"0";"" "Ale";"4744";"1440";"SE";"SE-O";"Karfreitag";"17";"2023-04-07";"2023-04-07";"1";"100";"0";"" "Ale";"4744";"1440";"SE";"SE-O";"Ostern";"18";"2023-04-09";"2023-04-09";"4";"100";"0";"" ... "Alingsås";"4745";"1489";"SE";"SE-O";"Neujahr";"1";"2023-01-01";"2023-01-01";"1";"100";"0";"" "Alingsås";"4745";"1489";"SE";"SE-O";"Heilige drei Könige";"4";"2023-01-06";"2023-01-06";"1";"100";"0";"" ...