Documentation de l'API

Contrôle de la fonction API

Vérifiez le statut de votre clé API

en utilisant la clé API

API: api_key

Fonction

Affiche l'état de votre clé API.

Guide interactif et OpenAPI

OpenAPI 3.0 (Swagger) – Documentation interactive sur l'API

Ouvre la documentation interactive de l'API avec Swagger, dans laquelle vous pouvez tester et explorer les points finaux de l'API.

Télécharger la spécification OpenAPI JSON

Chapitres de l'API

URL pour les requêtes
Paramètres des requêtes
Exemples (URL / PHP / Python / JavaScript)
Valeurs de retour de l'API
Exemples (JSON / XML / CSV)
Messages d'erreur

URL pour les requêtes

Pour récupérer les données, utilisez l'URL suivante. Veuillez faire attention aux majuscules et aux minuscules.

POST / GET

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

Paramètres des requêtes

Les variables suivantes vous permettent de compléter la requête et de contrôler les résultats de l'API.

Paramètre	Explication	Exemples
api_key requis	Votre clé API	api_key=abc-123-def-456
charset	Le codage souhaité de la réponse Variantes : UTF-8 (= standard) ISO-8859-1	charset=iso-8859-1
format	Le format de sortie souhaité Variantes : JSON (= standard) XML CSV	format=xml
date_format	Le format de date souhaité pour la réponse. Par défaut:`Y-m-d` (ex., 2025-12-31) Le format correspond au formatage de la date de l'instruction PHP date() Variantes : 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

Exemples (URL / PHP / Python / JavaScript)

Afficher les exemples

Paramètres dans l'URL

Ainsi, des paramètres peuvent être inclus dans l'URL (par exemple via le navigateur, ou dans Excel) :
Remarque : Le premier paramètre est précédé de ?, tous les autres paramètres sont précédés de &.

Important : ce code ne doit pas être utilisé directement dans une page web ! Pour des raisons de sécurité, les clés API doivent être traitées uniquement dans le backend.

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

Exemple PHP avec 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;

Exemple PHP avec 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;

Exemple Python avec 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)

Exemple Python avec 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)

Exemple JavaScript avec Fetch API (GET)

L'API Fetch est une méthode moderne pour effectuer des requêtes HTTP en JavaScript. Elle est prise en charge par les navigateurs actuels.

Important : ce code ne doit pas être utilisé directement dans une page web ! Pour des raisons de sécurité, les clés API doivent être traitées uniquement dans le backend.

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));

Exemple JavaScript avec Fetch API (POST)

L'API Fetch est une méthode moderne pour effectuer des requêtes HTTP en JavaScript. Elle est prise en charge par les navigateurs actuels.

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));

Valeurs de retour de l'API

Array		Explication	Exemple
interface		Version de l'API
source:	href	URL de la source de données (site web)
	description	Nom de la source des données
copyright	href	URL du titulaire du droit d'auteur (site web)
	description	Désignation du titulaire du droit d'auteur
apiName		Identification de l'API	api_key
date		Date d'exportation des données	01.05.2025
apiKeyStatus		Statut de la confirmation. Pour les variantes, voir les Messages d'erreur	active
apiDateStart		Date d'activation de l'accès à l'API	01.01.2015
apiDateEnd		Date de fin du contrat d'accès à l'API	31.12.2018
apiData
	dataPublicHolidays	Champ d'application des pays souscrits pour les jours fériés Options - all - Code pays ISO, 2 chiffres, séparé par une virgule	AT,CH,DE
	yearsPublicHolidays	Portée des années souscrites pour les jours fériés	2015,2016,2017,2018
	dataSchoolHolidays	Portée des pays souscrits pour les vacances scolaires Options - all - Code pays ISO, 2 chiffres, séparé par une virgule	CH
	yearsSchoolHolidays	Volume des années souscrites pour les vacances scolaires	2015,2016,2017,2018
apiList	api	Liste de toutes les API activées pour vous

Exemples (JSON / XML / CSV)

JSON

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

Réponse de l'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

Réponse de l'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

Réponse de l'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"

Messages d'erreur

Emplacement de la sortie	Message d'erreur	Explication
apiStatus
apiStatus: description	invalid usage	L'utilisation de cette API n'est pas activée pour cet utilisateur.
apiStatus: description	invalid key	Clé API invalide.
apiStatus: description	invalid referer	Accès non valable. Les liens à partir de pages web (front-ends) ne sont pas autorisés.
apiStatus: description	inactive	L'API n'a pas encore été activée pour l'utilisation.
apiStatus: description	expired	La période d'utilisation prévue par le contrat a expiré.

Espace développeurs

Contrôle de la fonction API

Vérifiez le statut de votre clé API

API: api_key

Fonction

Guide interactif et OpenAPI

Chapitres de l'API

URL pour les requêtes

Paramètres des requêtes

Exemples (URL / PHP / Python / JavaScript)

Valeurs de retour de l'API

Exemples (JSON / XML / CSV)

JSON

XML

CSV

Messages d'erreur

Pages

plus de psc Informatik

Feiertagskalender.ch

Soutenir le calendrier des jours fériés