Documentación API

Control de funciones API

[Status Ihres API-Keys prüfen]

mittels API-Key

API: api_key

[Funktion]

Gibt den Status Ihres API-Keys aus.

[Interaktive Anleitung und OpenAPI]

OpenAPI 3.0 (Swagger) – [Interaktive API-Dokumentation]

[Öffnet die interaktive API-Dokumentation mit Swagger, in der Sie API-Endpunkte testen und erkunden können.]

[OpenAPI JSON-Spezifikation herunterladen]

[API-Kapitel]

[URL für Anfragen]
[Parameter für Anfragen]
Ejemplos (URL / PHP / Python / JavaScript)
[Rückgabewerte des API]
Ejemplos (JSON / XML / CSV)
[Fehlermeldungen]

[URL für Anfragen]

[Zum Abrufen der Daten verwenden Sie folgende URL. Achten Sie bitte auf Gross-Kleinschrift.]

POST / GET

https://feiertagskalender.ch/api/api_key/index.php

[Parameter für Anfragen]

[Mit den folgenden Variablen können Sie die Abfrage vervollständigen und die API-Ergebnisse steuern.]

[Parameter]	[Erläuterung]	Ejemplos
api_key [erforderlich]	[Ihr API-Schlüssel]	api_key=abc-123-def-456
charset	[Die gewünschte Codierung der Antwort] [Varianten:] UTF-8 (= [Standard]) ISO-8859-1	charset=iso-8859-1
format	El formato de salida deseado [Varianten:] JSON (= [Standard]) XML CSV	format=xml
date_format	El formato de fecha deseado El formato corresponde al formato de fecha de la instrucción PHP date() [Varianten:] Y-m-d = YYYY-MM-DD (ISO-8601) (= [Standard]) d.m.Y = DD.MM.YYYY Ymd = YYYYMMDD dmY = DDMMYYYY d.m.y = DD.MM.YY j.n.y = D.M.YY	date_format=d.m.Y

Ejemplos (URL / PHP / Python / JavaScript)

Mostrar ejemplos

Parámetros de la URL

[So können Parameter in der URL mitgegeben werden (z.B. über den Browser, oder in Excel):]
[Hinweis: Der erste Parameter wird mit ? eingeleitet, alle weiteren Parameter werden mit & getrennt.]

[Wichtig: Dieser Code darf nicht direkt in einer Webseite verwendet werden! API-Schlüssel müssen aus Sicherheitsgründen nur im Backend verarbeitet werden.]

https://feiertagskalender.ch/api/api_key/index.php?api_key=YOUR_API_KEY&date_format=Y-m-d

Ejemplo PHP [mit] cURL (GET)

$api_url = "https://feiertagskalender.ch/api/api_key/index.php?date_format=Y-m-d";
$api_key = "YOUR_API_KEY";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
   "Authorization: Bearer $api_key",
   "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

Ejemplo PHP [mit] cURL (POST)

$api_url = "https://feiertagskalender.ch/api/api_key/index.php";
$api_key = "YOUR_API_KEY";

// POST-Daten
$post_data = json_encode([
    "date_format": "Y-m-d"	
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $api_key",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Ejemplo Python [mit] requests (GET)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/api_key/index.php?date_format=Y-m-d"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get(api_url, headers=headers)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Ejemplo Python [mit] requests (POST)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/api_key/index.php"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

payload = {
    "date_format": "Y-m-d"	
}

response = requests.post(api_url, headers=headers, json=payload)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Ejemplo JavaScript [mit] Fetch API (GET)

[Die Fetch API ist eine moderne Methode, um HTTP-Anfragen in JavaScript durchzuführen. Sie wird in aktuellen Browsern unterstützt.]

[Wichtig: Dieser Code darf nicht direkt in einer Webseite verwendet werden! API-Schlüssel müssen aus Sicherheitsgründen nur im Backend verarbeitet werden.]

const apiUrl = "https://feiertagskalender.ch/api/api_key/index.php?date_format=Y-m-d";
const apiKey = "YOUR_API_KEY";  								
const headers = new Headers({
    "Authorization": "Bearer " + apiKey,
    "Content-Type": "application/json"
});

fetch(apiUrl, { method: "GET", headers })
    .then(response => {
        if (!response.ok) {
            throw new Error(`Error: ${response.status} ${response.statusText}`);
        }
        return response.json();
    })
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));

Ejemplo JavaScript [mit] Fetch API (POST)

[Die Fetch API ist eine moderne Methode, um HTTP-Anfragen in JavaScript durchzuführen. Sie wird in aktuellen Browsern unterstützt.]

const apiUrl = "https://feiertagskalender.ch/api/api_key/index.php";
const apiKey = "YOUR_API_KEY";  
const requestData = {
    "date_format": "Y-m-d"	
};

fetch(apiUrl, {
    method: "POST",
    headers: {
        "Authorization": "Bearer " + apiKey,
        "Content-Type": "application/json"
    },
    body: JSON.stringify(requestData)
})
.then(response => {
    if (!response.ok) {
        throw new Error(`Error: ${response.status} ${response.statusText}`);
    }
    return response.json();
})
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

[Rückgabewerte des API]

Array		[Erläuterung]	Ejemplo
interface		[Version des API]
source:	href	[URL zur Datenquelle (Website)]
	description	Nombre de la fuente de datos
copyright	href	[URL zum Inhaber des Copyrights (Website)]
	description	Designación del titular de los derechos de autor
apiName		[Identifikation des API]	api_key
date		Fecha de exportación de los datos	29.10.2025
apiKeyStatus		[Status der Ausgabe]. [Für Varianten, siehe unter] [Fehlermeldungen]	active
apiDateStart		Fecha de activación del acceso a la API	01.01.2015
apiDateEnd		Fecha de finalización del contrato de acceso a la API	31.12.2018
apiData
	dataPublicHolidays	Umfang der abonnierten Länder für Feiertage [Optionen] - all - [ISO-Landeskürzel, 2-stellig], [kommasepariert]	AT,CH,DE
	yearsPublicHolidays	Umfang der abonnierten Jahre für Feiertage	2015,2016,2017,2018
	dataSchoolHolidays	Umfang der abonnierten Länder für Schulferien [Optionen] - all - [ISO-Landeskürzel, 2-stellig], [kommasepariert]	CH
	yearsSchoolHolidays	Umfang der abonnierten Jahre für Schulferien	2015,2016,2017,2018
apiList	api	Liste aller für Sie freigeschaltenen APIs

Ejemplos (JSON / XML / CSV)

JSON

URL:
https://www.feiertagskalender.ch/api/api_key/index.php?api_key=YOUR_API_KEY&date_format=Y-m-d

Respuesta de la API:

{
    "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 Arch"
    },
    "apiName": "api_key",
    "date": "2025-02-26",
    "apiKeyStatus": "active",
    "apiDateStart": "2021-03-31",
    "apiDateEnd": "2026-03-31",
    "apiData": {
        "dataPublicHolidays": "AT,CH,DE,LI",
        "yearsPublicHolidays": "2020,2021,2022,2023,2024,2025,2026",
        "dataSchoolHolidays": "AT,CH,DE,LI",
        "yearsSchoolHolidays": "2020,2021,2022,2023,2024,2025,2026"
    },
    "apiList": [
        {
            "api": "api_key"
        },
        {
            "api": "CheckDate/CH/BFS"
        },
        {
            "api": "CheckDate/CH/PLZ"
        },
        {
            "api": "CheckDate/GeoId"
        },
        {
            "api": "Data/Aggreg"
        },
        {
            "api": "Data/CH/BFS"
        },
        {
            "api": "Data/CH/Kanton"
        },
        {
            "api": "Data/CH/PLZ"
        },
        {
            "api": "Data/Country"
        },
        {
            "api": "Data/Country/CH"
        },
        {
            "api": "Data/Country/CH/PLZ"
        },
        {
            "api": "Data/Country/LI"
        },
        {
            "api": "Data/Country/LI/PLZ"
        },
        {
            "api": "Data/GeoId"
        },
        {
            "api": "GeoTree/CH"
        },
        {
            "api": "GeoTree/ISO"
        }
    ]
}

XML

URL:
https://www.feiertagskalender.ch/api/api_key/index.php?api_key=YOUR_API_KEY&date_format=Y-m-d&format=xml

Respuesta de la API:

<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>
<date>2025-02-26</date>
<apiName>api_key</apiName>
<apiKeyStatus>active</apiKeyStatus>
<apiDateStart>2021-03-31</apiDateStart>
<apiDateEnd>2026-03-31</apiDateEnd>
<apiData>
<dataPublicHolidays>AT,CH,DE,LI</dataPublicHolidays>
<yearsPublicHolidays>2020,2021,2022,2023,2024,2025,2026</yearsPublicHolidays>
<dataSchoolHolidays>AT,CH,DE,LI</dataSchoolHolidays>
<yearsSchoolHolidays>2020,2021,2022,2023,2024,2025,2026</yearsSchoolHolidays>
</apiData>
<apiList>
<api>api_key</api>
<api>CheckDate/CH/BFS</api>
<api>CheckDate/CH/PLZ</api>
<api>CheckDate/GeoId</api>
<api>Data/Aggreg</api>
<api>Data/CH/BFS</api>
<api>Data/CH/Kanton</api>
<api>Data/CH/PLZ</api>
<api>Data/Country</api>
<api>Data/Country/CH</api>
<api>Data/Country/CH/PLZ</api>
<api>Data/Country/LI</api>
<api>Data/Country/LI/PLZ</api>
<api>Data/GeoId</api>
<api>GeoTree/CH</api>
<api>GeoTree/ISO</api>
</apiList>
</fcal_api>

CSV

Aufruf:
https://www.feiertagskalender.ch/api/api_key/index.php?api_key=YOUR_API_KEY&date_format=Y-m-d&format=csv

Respuesta de la API:

"interface";"apiKeyStatus";"apiDateStart";"apiDateEnd";"dataPublicHolidays";"yearsPublicHolidays";"dataSchoolHolidays";"yearsSchoolHolidays";"api"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"api_key"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"CheckDate/CH/BFS"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"CheckDate/CH/PLZ"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"CheckDate/GeoId"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Aggreg"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/CH/BFS"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/CH/Kanton"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/CH/PLZ"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Country"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Country/CH"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Country/CH/PLZ"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Country/LI"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/Country/LI/PLZ"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"Data/GeoId"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"GeoTree/CH"
"fcal API 2.0";"active";"2021-03-31";"2026-03-31";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"AT,CH,DE,LI";"2020,2021,2022,2023,2024,2025,2026";"GeoTree/ISO"

[Fehlermeldungen]

Tipo de salida	[Fehlermeldung]	[Erläuterung]
apiStatus
apiStatus: description	invalid usage	[Die Verwendung dieses API ist für diesen Nutzer nicht freigeschaltet.]
apiStatus: description	invalid key	[Ungültiger API-Schlüssel.]
apiStatus: description	invalid referer	[Ungültiger Zugriff. Links ab Webseiten (Front-Ends) sind nicht zulässig.]
apiStatus: description	inactive	[Das API wurde für noch nicht zur Benutzung freigeschaltet.]
apiStatus: description	expired	[Die Nutzungsdauer nach Vertrag ist abgelaufen.]

[Entwickler-Ebene]

Control de funciones API

[Status Ihres API-Keys prüfen]

API: api_key

[Funktion]

[Interaktive Anleitung und OpenAPI]

[API-Kapitel]

[URL für Anfragen]

[Parameter für Anfragen]

Ejemplos (URL / PHP / Python / JavaScript)

[Rückgabewerte des API]

Ejemplos (JSON / XML / CSV)

JSON

XML

CSV

[Fehlermeldungen]

[Seiten]

[mehr von psc Informatik]

Feiertagskalender.ch

[Feiertagskalender unterstützen]