Documentation de l'API

Données annuelles

API: Data/CityId

Obtient les jours fériés et les vacances scolaires pour une année entière, en se basant sur un `cityId`.

Fonction

Cette API détermine les jours de l'année où un jour férié officiel ou des vacances scolaires ont lieu à un endroit donné. Les paramètres requis sont `api_key` et `cityId`. Le paramètre `year` est facultatif - s'il n'est pas indiqué, l'année actuelle est automatiquement utilisée. En outre, la sortie peut être configurée à l'aide d'autres paramètres. Les paramètres sont transmis comme paramètres de requête dans l'URL. Alternativement, l'autorisation peut être donnée dans l'en-tête.

Les City-ID disponibles se trouvent dans l'API :GeoTree/ISO

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

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/CityId/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
cityId
requis		 City-ID de la localité souhaitée. Le City-ID de Feiertagskalender.ch est utilisé. cityid=88
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
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

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/CityId
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: cityId       City-ID selon la demande 88
  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
  location description     Nom de l'unité géographique Berlin
    cityId     Géo-ID de l'unité géographique. 88
    iso     Code pays ISO, 2 chiffres DE
    iso-3166-2     Code de région selon la norme ISO 3166-2 DE-BE
    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/CityId/index.php?api_key=YOUR_API_KEY&cityid=89&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/CityId",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-26",
    "request": {
        "cityId": "89",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "location": {
            "description": "Zurich",
            "cityId": "89",
            "iso": "CH",
            "iso-3166-2": "CH-ZH",
            "note": "",
            "events": [
                {
                    "description": "Neujahr",
                    "id": "1",
                    "dateStart": "2022-01-01",
                    "dateEnd": "2022-01-01",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Berchtoldstag",
                    "id": "3",
                    "dateStart": "2022-01-02",
                    "dateEnd": "2022-01-02",
                    "class": "4",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Karfreitag",
                    "id": "17",
                    "dateStart": "2022-04-15",
                    "dateEnd": "2022-04-15",
                    "class": "2",
                    "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": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Sechseläuten",
                    "id": "20",
                    "dateStart": "2022-04-25",
                    "dateEnd": "2022-04-25",
                    "class": "4",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Tag der Arbeit",
                    "id": "22",
                    "dateStart": "2022-05-01",
                    "dateEnd": "2022-05-01",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Auffahrt",
                    "id": "31",
                    "dateStart": "2022-05-26",
                    "dateEnd": "2022-05-26",
                    "class": "2",
                    "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": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Nationalfeiertag Schweiz",
                    "id": "12",
                    "dateStart": "2022-08-01",
                    "dateEnd": "2022-08-01",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Knabenschiessen",
                    "id": "60",
                    "dateStart": "2022-09-12",
                    "dateEnd": "2022-09-12",
                    "class": "4",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Weihnachten",
                    "id": "23",
                    "dateStart": "2022-12-25",
                    "dateEnd": "2022-12-25",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Stephanstag",
                    "id": "37",
                    "dateStart": "2022-12-26",
                    "dateEnd": "2022-12-26",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                }
            ]
        }
    }
}

XML

URL :
https://www.feiertagskalender.ch/api/Data/CityId/index.php?api_key=YOUR_API_KEY&cityid=89&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/CityId</apiName>
<date>2025-02-26</date>
<request>
<cityId>89</cityId>
<year>2022</year>
<class>4</class>
<charset>utf-8</charset>
<format>xml</format>
<date_format>Y-m-d</date_format>
<hl>de</hl>
</request>
<results>
<status>
<description>ok</description>
</status>
<location>
<description>Zurich,</description>
<cityId>89</cityId>
<iso>CH</iso>
<iso-3166-2>CH-ZH</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sechseläuten</description>
<id>20</id>
<dateStart>2022-04-25</dateStart>
<dateEnd>2022-04-25</dateEnd>
<class>4</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrt</description>
<id>31</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-26</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Nationalfeiertag Schweiz</description>
<id>12</id>
<dateStart>2022-08-01</dateStart>
<dateEnd>2022-08-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Knabenschiessen</description>
<id>60</id>
<dateStart>2022-09-12</dateStart>
<dateEnd>2022-09-12</dateEnd>
<class>4</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Stephanstag</description>
<id>37</id>
<dateStart>2022-12-26</dateStart>
<dateEnd>2022-12-26</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
</results>
</fcal_api>

CSV

URL :
https://www.feiertagskalender.ch/api/Data/CityId/index.php?api_key=YOUR_API_KEY&cityid=89&year=2022&format=csv

Réponse de l'API :

"location";"cityId";"iso";"iso-3166-2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Zurich";"89";"CH";"CH-ZH";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"4";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Sechseläuten";"20";"2022-04-25";"2022-04-25";"4";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Knabenschiessen";"60";"2022-09-12";"2022-09-12";"4";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";""
"Zurich";"89";"CH";"CH-ZH";"Stephanstag";"37";"2022-12-26";"2022-12-26";"2";"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 La City-ID demandée n'est pas connue.
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é.
© 2003 - 2025 psc Peter Schütz Informatik Dienstleistungen, CH-Arch