Documentation de l'API

Données annuelles

Lire les données annuelles pour plusieurs lieux

Pays et régions en utilisant du code pays ISO Toutes les communes de Suisse, y compris les numéros de commune

Tous les codes postaux Suisse, y compris les numéros de commune

Toutes les communes pour 1 canton suisse

Toutes les communes de Liechtenstein, y compris les numéros de commune

Tous les codes postaux du Liechtenstein, y compris les numéros de commune

Toutes les communes de Suède (y compris les codes des communes).

API: Data/Country

Obtient les jours fériés et les vacances scolaires pour une année entière pour toutes les entrées disponibles d'un pays, en se basant sur une abréviation ISO du pays (iso).

Fonction

Cette API détermine, pour toutes les unités géographiques saisies d'un pays, les jours de l'année où il y a un jour férié officiel ou des vacances scolaires. Les paramètres requis sont `api_key` et `geoId`. Le paramètre `year` est facultatif - s'il n'est pas indiqué, l'année actuelle est automatiquement utilisée. De plus, la sortie peut être configurée à l'aide d'autres paramètres. Les paramètres sont transmis sous forme de JSON dans le corps de la requête. Alternativement, l'autorisation peut être donnée dans l'en-tête.

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/Data/Country/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
iso requis	Code pays ISO, 2 chiffres	iso=DE
year oubièn jahr	Année des dates demandées sans précision : année civile en cours (= standard)	year= 2026
class oubièn klasse	Portée des données Variantes : 0 = vacances scolaires uniquement 3 = 0 + jours fériés reconnus par la loi 4 = 0 + 3 + jours fériés (religieux, culturels) et non fériés (= standard) 5 = 0 + 3 + 4 + jours d'événements (par exemple, le Saint-Valentin, la fête des mères, les dimanches de l'Avent))	klasse=5
all_entities	Portée des données 0 = niveaux Pays et ISO-3166-2 uniquement (= standard) 1 = toutes les unités couvertes	&all_entities=1
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
hl	Langue de sortie souhaitée Variantes : de = Allemand (= standard) fr = Français it = Italien en = Anglais	hl=en

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/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022

Exemple PHP avec cURL (GET)

$api_url = "https://feiertagskalender.ch/api/Data/Country/index.php?iso=FR&year=2022";
$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/Data/Country/index.php";
$api_key = "YOUR_API_KEY";

// POST-Daten
$post_data = json_encode([
    "iso": "FR", "year": "2022"	
]);

$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/Data/Country/index.php?iso=FR&year=2022"
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/Data/Country/index.php"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

payload = {
    "iso": "FR", "year": "2022"	
}

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/Data/Country/index.php?iso=FR&year=2022";
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/Data/Country/index.php";
const apiKey = "YOUR_API_KEY";  
const requestData = {
    "iso": "FR", "year": "2022"	
};

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

Le contenu des réponses de l'API résulte de :
- les données auxquelles vous avez souscrit (pays, vacances, congés scolaires, années civiles)
- les données officiellement connues des législateurs
- la disponibilité en fonction de nos recherches (situation réelle de notre base de données)

Veuillez noter que la version en format CSV diffère.

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	Data/Country
apiStatus	description				Désignation du statut de l'API. Pour les variantes, voir les Messages d'erreur	active
date					Date d'exportation des données	01.05.2025
request:	iso				Code pays ISO, 2 chiffres	DE
	year				Année des données dans la production	2015
	class				Classe de la requête (concerne l'étendue des données)	4
	charset				Codage de la police de la sortie	utf-8
	format				Format des données de la sortie	json
	date_format				Format de la date de la sortie	d.m.Y
	hl				Langue de délivrance, selon la demande	fr
results	status	description			Statut de la confirmation. Pour les variantes, voir les Messages d'erreur	ok
	locations	location	description		Nom de l'unité géographique	Baden-Wurttemberg
			type		Désignation du type d'unité géographique	Etat
			geoId		Géo-ID de l'unité géographique.	3060
			iso		Code pays ISO, 2 chiffres	DE
			iso-3166-2		Code de région selon la norme ISO 3166-2	DE-BW
			note		Notes spéciales
			events		Les événements du calendrier
				description	Désignation du jour férié, ou des vacances scolaires	Nouvel an
				id	ID unique de l'événement. Les jours fériés ont la même ID chaque année. Les vacances scolaires ont toutes leur propre ID.	1
				dateStart	Date Début de l'événement	01.01.2015
				dateEnd	Date Fin de l'événement	01.01.2015
				class	Classe de l'événement : 0 = Vacances scolaires 1 = jour férié légalement reconnu 2 = Jour férié assimilé aux dimanches 3 = demi-jour férié légal (généralement à partir de midi) 4 = jour férié non reconnu par la loi (magasins, écoles, administrations habituellement fermés), jour férié ; aux fins de la Convention européenne sur le calcul des délais, ce jour est traité comme un jour férié (article 5). 5 = Événement # = partiellement valable	2
				percent	Pourcentage d'habitants / de classes d'école touchés	100
				prov	Indicateur pour les données définies provisoirement 0 = définitivement 1 = provisoire	0
				note	notes spéciales

Exemples (JSON / XML / CSV)

JSON

URL :
https://www.feiertagskalender.ch/api/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022

Réponse de l'API :

{
    "interface": "fcal API 2.02",
    "source": {
        "href": "https://feiertagskalender.ch",
        "description": "feiertagskalender.ch"
    },
    "copyright": {
        "href": "https://psc.ch",
        "description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Arch"
    },
    "apiName": "Data/Country",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "iso": "FR",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "all_entities": 0,
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "locations": [
            {
                "description": "Auvergne-Rhône-Alpes",
                "type": "Region",
                "geoId": "3099",
                "parentId": "3079",
                "iso": "FR",
                "iso-3166-2": "FR-ARA",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag der Arbeit",
                        "id": "22",
                        "dateStart": "2022-05-01",
                        "dateEnd": "2022-05-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag des Sieges 1945",
                        "id": "97",
                        "dateStart": "2022-05-08",
                        "dateEnd": "2022-05-08",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Christi Himmelfahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingsten",
                        "id": "30",
                        "dateStart": "2022-06-05",
                        "dateEnd": "2022-06-05",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "35",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Frankreich",
                        "id": "96",
                        "dateStart": "2022-07-14",
                        "dateEnd": "2022-07-14",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Mariä Himmelfahrt",
                        "id": "42",
                        "dateStart": "2022-08-15",
                        "dateEnd": "2022-08-15",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Allerheiligen",
                        "id": "47",
                        "dateStart": "2022-11-01",
                        "dateEnd": "2022-11-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Gedenktag 1918",
                        "id": "98",
                        "dateStart": "2022-11-11",
                        "dateEnd": "2022-11-11",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "812135",
                        "dateStart": "2021-12-19",
                        "dateEnd": "2022-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "812136",
                        "dateStart": "2022-02-13",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Frühlingsferien",
                        "id": "812137",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "812138",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "812139",
                        "dateStart": "2022-07-07",
                        "dateEnd": "2022-08-31",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "826980",
                        "dateStart": "2022-10-22",
                        "dateEnd": "2022-11-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "826981",
                        "dateStart": "2022-12-17",
                        "dateEnd": "2023-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "description": "Bourgogne-Franche-Comté",
                "type": "Region",
                "geoId": "3101",
                "parentId": "3079",
                "iso": "FR",
                "iso-3166-2": "FR-BFC",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag der Arbeit",
                        "id": "22",
                        "dateStart": "2022-05-01",
                        "dateEnd": "2022-05-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag des Sieges 1945",
                        "id": "97",
                        "dateStart": "2022-05-08",
                        "dateEnd": "2022-05-08",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Christi Himmelfahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingsten",
                        "id": "30",
                        "dateStart": "2022-06-05",
                        "dateEnd": "2022-06-05",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "35",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Frankreich",
                        "id": "96",
                        "dateStart": "2022-07-14",
                        "dateEnd": "2022-07-14",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Mariä Himmelfahrt",
                        "id": "42",
                        "dateStart": "2022-08-15",
                        "dateEnd": "2022-08-15",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Allerheiligen",
                        "id": "47",
                        "dateStart": "2022-11-01",
                        "dateEnd": "2022-11-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Gedenktag 1918",
                        "id": "98",
                        "dateStart": "2022-11-11",
                        "dateEnd": "2022-11-11",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "812232",
                        "dateStart": "2021-12-19",
                        "dateEnd": "2022-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "812233",
                        "dateStart": "2022-02-13",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Frühlingsferien",
                        "id": "812234",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "812236",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "812235",
                        "dateStart": "2022-07-07",
                        "dateEnd": "2022-08-31",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "827049",
                        "dateStart": "2022-10-22",
                        "dateEnd": "2022-11-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "827050",
                        "dateStart": "2022-12-17",
                        "dateEnd": "2023-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            }
        ]
    }
}

XML

URL :
https://www.feiertagskalender.ch/api/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022&format=xml

Réponse de l'API :

<fcal_api>
	<interface>fcal API 2.02</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</apiName>
	<date>2025-02-27</date>
	<request>
		<iso>FR</iso>
		<year>2022</year>
		<class>4</class>
		<charset>utf-8</charset>
		<format>xml</format>
		<date_format>Y-m-d</date_format>
		<all_entities>0</all_entities>
		<hl>de</hl>
	</request>
	<results>
		<status>
			<description>ok</description>
		</status>
		<locations>
			<location>
				<description>Auvergne-Rhône-Alpes</description>
				<type>Region</type>
				<geoId>3099</geoId>
				<parentId>3079</parentId>
				<iso>FR</iso>
				<iso-3166-2>FR-ARA</iso-3166-2>
				<note></note>
				<events>
					<event>
						<description>Neujahr</description>
						<id>1</id>
						<dateStart>2022-01-01</dateStart>
						<dateEnd>2022-01-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Ostern</description>
						<id>18</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-04-17</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Ostermontag</description>
						<id>19</id>
						<dateStart>2022-04-18</dateStart>
						<dateEnd>2022-04-18</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag der Arbeit</description>
						<id>22</id>
						<dateStart>2022-05-01</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag des Sieges 1945</description>
						<id>97</id>
						<dateStart>2022-05-08</dateStart>
						<dateEnd>2022-05-08</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Christi Himmelfahrt</description>
						<id>31</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingsten</description>
						<id>30</id>
						<dateStart>2022-06-05</dateStart>
						<dateEnd>2022-06-05</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingstmontag</description>
						<id>35</id>
						<dateStart>2022-06-06</dateStart>
						<dateEnd>2022-06-06</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Nationalfeiertag Frankreich</description>
						<id>96</id>
						<dateStart>2022-07-14</dateStart>
						<dateEnd>2022-07-14</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Mariä Himmelfahrt</description>
						<id>42</id>
						<dateStart>2022-08-15</dateStart>
						<dateEnd>2022-08-15</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Allerheiligen</description>
						<id>47</id>
						<dateStart>2022-11-01</dateStart>
						<dateEnd>2022-11-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Gedenktag 1918</description>
						<id>98</id>
						<dateStart>2022-11-11</dateStart>
						<dateEnd>2022-11-11</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachten</description>
						<id>23</id>
						<dateStart>2022-12-25</dateStart>
						<dateEnd>2022-12-25</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>812135</id>
						<dateStart>2021-12-19</dateStart>
						<dateEnd>2022-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Winterferien</description>
						<id>812136</id>
						<dateStart>2022-02-13</dateStart>
						<dateEnd>2022-02-27</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Frühlingsferien</description>
						<id>812137</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Auffahrtsferien</description>
						<id>812138</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Sommerferien</description>
						<id>812139</id>
						<dateStart>2022-07-07</dateStart>
						<dateEnd>2022-08-31</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Herbstferien</description>
						<id>826980</id>
						<dateStart>2022-10-22</dateStart>
						<dateEnd>2022-11-06</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>826981</id>
						<dateStart>2022-12-17</dateStart>
						<dateEnd>2023-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
				</events>
			</location>
			<location>
				<description>Bourgogne-Franche-Comté</description>
				<type>Region</type>
				<geoId>3101</geoId>
				<parentId>3079</parentId>
				<iso>FR</iso>
				<iso-3166-2>FR-BFC</iso-3166-2>
				<note></note>
				<events>
					<event>
						<description>Neujahr</description>
						<id>1</id>
						<dateStart>2022-01-01</dateStart>
						<dateEnd>2022-01-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Ostern</description>
						<id>18</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-04-17</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Ostermontag</description>
						<id>19</id>
						<dateStart>2022-04-18</dateStart>
						<dateEnd>2022-04-18</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag der Arbeit</description>
						<id>22</id>
						<dateStart>2022-05-01</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag des Sieges 1945</description>
						<id>97</id>
						<dateStart>2022-05-08</dateStart>
						<dateEnd>2022-05-08</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Christi Himmelfahrt</description>
						<id>31</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingsten</description>
						<id>30</id>
						<dateStart>2022-06-05</dateStart>
						<dateEnd>2022-06-05</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingstmontag</description>
						<id>35</id>
						<dateStart>2022-06-06</dateStart>
						<dateEnd>2022-06-06</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Nationalfeiertag Frankreich</description>
						<id>96</id>
						<dateStart>2022-07-14</dateStart>
						<dateEnd>2022-07-14</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Mariä Himmelfahrt</description>
						<id>42</id>
						<dateStart>2022-08-15</dateStart>
						<dateEnd>2022-08-15</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Allerheiligen</description>
						<id>47</id>
						<dateStart>2022-11-01</dateStart>
						<dateEnd>2022-11-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Gedenktag 1918</description>
						<id>98</id>
						<dateStart>2022-11-11</dateStart>
						<dateEnd>2022-11-11</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachten</description>
						<id>23</id>
						<dateStart>2022-12-25</dateStart>
						<dateEnd>2022-12-25</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>812232</id>
						<dateStart>2021-12-19</dateStart>
						<dateEnd>2022-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Winterferien</description>
						<id>812233</id>
						<dateStart>2022-02-13</dateStart>
						<dateEnd>2022-02-27</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Frühlingsferien</description>
						<id>812234</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Auffahrtsferien</description>
						<id>812236</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Sommerferien</description>
						<id>812235</id>
						<dateStart>2022-07-07</dateStart>
						<dateEnd>2022-08-31</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Herbstferien</description>
						<id>827049</id>
						<dateStart>2022-10-22</dateStart>
						<dateEnd>2022-11-06</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>827050</id>
						<dateStart>2022-12-17</dateStart>
						<dateEnd>2023-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
				</events>
			</location>
		</locations>
	</results>
</fcal_api>

CSV

Aufruf:
https://www.feiertagskalender.ch/api/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022&format=csv

Réponse de l'API :

"location";"geoId";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Neujahr";"1";"2022-01-01";"2022-01-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Ostermontag";"19";"2022-04-18";"2022-04-18";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Tag des Sieges 1945";"97";"2022-05-08";"2022-05-08";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Christi Himmelfahrt";"31";"2022-05-26";"2022-05-26";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Nationalfeiertag Frankreich";"96";"2022-07-14";"2022-07-14";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Mariä Himmelfahrt";"42";"2022-08-15";"2022-08-15";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Allerheiligen";"47";"2022-11-01";"2022-11-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Gedenktag 1918";"98";"2022-11-11";"2022-11-11";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachten";"23";"2022-12-25";"2022-12-25";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachtsferien";"812135";"2021-12-19";"2022-01-02";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Winterferien";"812136";"2022-02-13";"2022-02-27";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Frühlingsferien";"812137";"2022-04-17";"2022-05-01";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Auffahrtsferien";"812138";"2022-05-26";"2022-05-26";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Sommerferien";"812139";"2022-07-07";"2022-08-31";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Herbstferien";"826980";"2022-10-22";"2022-11-06";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachtsferien";"826981";"2022-12-17";"2023-01-02";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Neujahr";"1";"2022-01-01";"2022-01-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Ostermontag";"19";"2022-04-18";"2022-04-18";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Tag des Sieges 1945";"97";"2022-05-08";"2022-05-08";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Christi Himmelfahrt";"31";"2022-05-26";"2022-05-26";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Nationalfeiertag Frankreich";"96";"2022-07-14";"2022-07-14";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Mariä Himmelfahrt";"42";"2022-08-15";"2022-08-15";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Allerheiligen";"47";"2022-11-01";"2022-11-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Gedenktag 1918";"98";"2022-11-11";"2022-11-11";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachten";"23";"2022-12-25";"2022-12-25";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachtsferien";"812232";"2021-12-19";"2022-01-02";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Winterferien";"812233";"2022-02-13";"2022-02-27";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Frühlingsferien";"812234";"2022-04-17";"2022-05-01";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Auffahrtsferien";"812236";"2022-05-26";"2022-05-26";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Sommerferien";"812235";"2022-07-07";"2022-08-31";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Herbstferien";"827049";"2022-10-22";"2022-11-06";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachtsferien";"827050";"2022-12-17";"2023-01-02";"0";"100";"0";""

Messages d'erreur

Emplacement de la sortie	Message d'erreur	Explication
results: status:
results: status: description	not subscribed	Vous n'avez pas souscrit aux données souhaitées.
results: status: description	unknown location	Le code pays ISO demandé n'est pas connu. Veuillez vérifier le paramètre ISO
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

Données annuelles

Lire les données annuelles pour plusieurs lieux

API: Data/Country

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