Obtient l'arbre géopraphique pour toutes les entrées disponibles d'un pays, en se basant sur un code ISO de pays (iso).
Cette API lit l'arbre géographique d'un pays ou d'une région. Elle permet ainsi de déterminer les geoIds nécessaires pour d'autres requêtes. Les paramètres requis sont `api_key` et `iso`. 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.
**Remarque:** L'arbre géographique contient toutes les entrées résultant de la nécessité de représenter correctement les jours fériés et les vacances scolaires. De plus, il existe une base de données de lieux séparée avec des lieux supplémentaires qui sont situés dans notre arborescence. Le paramètre `cities` (0/1) permet de définir si la base de données des lieux doit être incluse dans la sortie de l'arbre géographique.
Ouvre la documentation interactive de l'API avec Swagger, dans laquelle vous pouvez tester et explorer les points finaux de l'API.
Pour récupérer les données, utilisez l'URL suivante. Veuillez faire attention aux majuscules et aux minuscules.
https://feiertagskalender.ch/api/GeoTree/ISO/index.php
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, oubièn Code de région selon la norme ISO 3166-2 |
iso=DE-BW |
cities | Drapeau pour l'exportation étendue avec les villes enregistrées : Variantes : |
&cities=1 |
charset | Le codage souhaité de la réponse Variantes : |
charset=iso-8859-1 |
format | Le format de sortie souhaité Variantes : |
format=xml |
hl | Langue de sortie souhaitée Variantes : |
hl=en |
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 | GeoTree/ISO | ||||
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 | 23.10.2025 | ||||
request: | iso | Code pays ISO, 2 chiffres | BE | |||
charset | Codage de la police de la sortie | utf-8 | ||||
format | Format des données de la sortie | json | ||||
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 | Unité géographique selon la requête | |||||
description | Nom de l'unité géographique | Belgique | ||||
type | Désignation du type d'unité géographique | Pays | ||||
geoId | Géo-ID de l'unité géographique. | 3285 | ||||
iso | Code pays ISO, 2 chiffres | BE | ||||
iso-3166-2 | Code de région selon la norme ISO 3166-2 | |||||
cities | Toutes les villes et localités couvertes dans cette région | |||||
description | ||||||
cityId | ||||||
children | Toute unité géographique subordonnée | |||||
description | Nom de l'unité géographique | Bruxelles | ||||
type | Désignation du type d'unité géographique | Région | ||||
geoId | Géo-ID de l'unité géographique. | 3288 | ||||
iso | Code pays ISO, 2 chiffres | BE | ||||
iso-3166-2 | Code de région selon la norme ISO 3166-2 | BE-BRU | ||||
cities | Toutes les villes et localités couvertes dans cette région | |||||
children | Toute unité géographique subordonnée (jusqu'à 4 niveaux sont possibles) |
array |
URL :
https://www.feiertagskalender.ch/api/GeoTree/ISO/index.php?api_key=YOUR_API_KEY&iso=FR
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": "GeoTree/ISO", "apiStatus": { "description": "active" }, "date": "2025-02-28", "request": { "iso": "FR", "charset": "utf-8", "format": "json", "hl": "de" }, "results": { "status": { "description": "ok" }, "location": { "description": "Frankreich", "type": "Land", "geoId": "3079", "iso": "FR", "iso-3166-2": "", "cities": null, "children": [ { "description": "Auvergne-Rhône-Alpes", "type": "Region", "geoId": "3099", "iso": "FR", "iso-3166-2": "FR-ARA", "cities": null, "children": [ { "description": "Ain", "type": "Departement", "geoId": "4142", "iso": "FR", "iso-3166-2": "FR-01", "cities": null, "children": null }, { "description": "Allier", "type": "Departement", "geoId": "4143", "iso": "FR", "iso-3166-2": "FR-03", "cities": null, "children": null }, { "description": "Ardèche", "type": "Departement", "geoId": "4144", "iso": "FR", "iso-3166-2": "FR-07", "cities": null, "children": null }, { "description": "Cantal", "type": "Departement", "geoId": "4145", "iso": "FR", "iso-3166-2": "FR-15", "cities": null, "children": null }, { "description": "Drôme", "type": "Departement", "geoId": "4146", "iso": "FR", "iso-3166-2": "FR-26", "cities": null, "children": null }, { "description": "Haute-Loire", "type": "Departement", "geoId": "4149", "iso": "FR", "iso-3166-2": "FR-43", "cities": null, "children": null }, { "description": "Haute-Savoie", "type": "Departement", "geoId": "4154", "iso": "FR", "iso-3166-2": "FR-74", "cities": null, "children": null }, { "description": "Isère", "type": "Departement", "geoId": "4147", "iso": "FR", "iso-3166-2": "FR-38", "cities": null, "children": null }, { "description": "Loire", "type": "Departement", "geoId": "4148", "iso": "FR", "iso-3166-2": "FR-42", "cities": null, "children": null }, { "description": "Métropole de Lyon", "type": "Departement", "geoId": "4152", "iso": "FR", "iso-3166-2": "FR-69", "cities": null, "children": null }, { "description": "Puy-de-Dôme", "type": "Departement", "geoId": "4150", "iso": "FR", "iso-3166-2": "FR-63", "cities": null, "children": null }, { "description": "Rhône", "type": "Departement", "geoId": "4151", "iso": "FR", "iso-3166-2": "FR-69", "cities": null, "children": null }, { "description": "Savoie", "type": "Departement", "geoId": "4153", "iso": "FR", "iso-3166-2": "FR-73", "cities": null, "children": null } ] }, { "description": "Bourgogne-Franche-Comté", "type": "Region", "geoId": "3101", "iso": "FR", "iso-3166-2": "FR-BFC", "cities": null, "children": [ { "description": "Côte-d’Or", "type": "Departement", "geoId": "4207", "iso": "FR", "iso-3166-2": "FR-21", "cities": null, "children": null }, { "description": "Doubs", "type": "Departement", "geoId": "4208", "iso": "FR", "iso-3166-2": "FR-25", "cities": null, "children": null }, { "description": "Haute-Saône", "type": "Departement", "geoId": "4211", "iso": "FR", "iso-3166-2": "FR-70", "cities": null, "children": null }, { "description": "Jura", "type": "Departement", "geoId": "4209", "iso": "FR", "iso-3166-2": "FR-39", "cities": null, "children": null }, { "description": "Nièvre", "type": "Departement", "geoId": "4210", "iso": "FR", "iso-3166-2": "FR-58", "cities": null, "children": null }, { "description": "Saône-et-Loire", "type": "Departement", "geoId": "4212", "iso": "FR", "iso-3166-2": "FR-71", "cities": null, "children": null }, { "description": "Territoire de Belfort", "type": "Departement", "geoId": "4214", "iso": "FR", "iso-3166-2": "FR-90", "cities": null, "children": null }, { "description": "Yonne", "type": "Departement", "geoId": "4213", "iso": "FR", "iso-3166-2": "FR-89", "cities": null, "children": null } ] } ] } } }
URL :
https://www.feiertagskalender.ch/api/GeoTree/ISO/index.php?api_key=YOUR_API_KEY&iso=FR&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>GeoTree/ISO</apiName> <date>2025-02-28</date> <request> <iso>FR</iso> <charset>utf-8</charset> <format>xml</format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Frankreich</description> <type>Land</type> <geoId>3079</geoId> <iso>FR</iso> <iso-3166-2></iso-3166-2> <cities></cities> <children> <child> <description>Auvergne-Rhône-Alpes</description> <type>Region</type> <geoId>3099</geoId> <iso>FR</iso> <iso-3166-2>FR-ARA</iso-3166-2> <cities></cities> <children> <child> <description>Ain</description> <type>Departement</type> <geoId>4142</geoId> <iso>FR</iso> <iso-3166-2>FR-01</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Allier</description> <type>Departement</type> <geoId>4143</geoId> <iso>FR</iso> <iso-3166-2>FR-03</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Ardèche</description> <type>Departement</type> <geoId>4144</geoId> <iso>FR</iso> <iso-3166-2>FR-07</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Cantal</description> <type>Departement</type> <geoId>4145</geoId> <iso>FR</iso> <iso-3166-2>FR-15</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Drôme</description> <type>Departement</type> <geoId>4146</geoId> <iso>FR</iso> <iso-3166-2>FR-26</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Haute-Loire</description> <type>Departement</type> <geoId>4149</geoId> <iso>FR</iso> <iso-3166-2>FR-43</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Haute-Savoie</description> <type>Departement</type> <geoId>4154</geoId> <iso>FR</iso> <iso-3166-2>FR-74</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Isère</description> <type>Departement</type> <geoId>4147</geoId> <iso>FR</iso> <iso-3166-2>FR-38</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Loire</description> <type>Departement</type> <geoId>4148</geoId> <iso>FR</iso> <iso-3166-2>FR-42</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Métropole de Lyon</description> <type>Departement</type> <geoId>4152</geoId> <iso>FR</iso> <iso-3166-2>FR-69</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Puy-de-Dôme</description> <type>Departement</type> <geoId>4150</geoId> <iso>FR</iso> <iso-3166-2>FR-63</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Rhône</description> <type>Departement</type> <geoId>4151</geoId> <iso>FR</iso> <iso-3166-2>FR-69</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Savoie</description> <type>Departement</type> <geoId>4153</geoId> <iso>FR</iso> <iso-3166-2>FR-73</iso-3166-2> <cities></cities> <children></children> </child> </children> </child> <child> <description>Bourgogne-Franche-Comté</description> <type>Region</type> <geoId>3101</geoId> <iso>FR</iso> <iso-3166-2>FR-BFC</iso-3166-2> <cities></cities> <children> <child> <description>Côte-d’Or</description> <type>Departement</type> <geoId>4207</geoId> <iso>FR</iso> <iso-3166-2>FR-21</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Doubs</description> <type>Departement</type> <geoId>4208</geoId> <iso>FR</iso> <iso-3166-2>FR-25</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Haute-Saône</description> <type>Departement</type> <geoId>4211</geoId> <iso>FR</iso> <iso-3166-2>FR-70</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Jura</description> <type>Departement</type> <geoId>4209</geoId> <iso>FR</iso> <iso-3166-2>FR-39</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Nièvre</description> <type>Departement</type> <geoId>4210</geoId> <iso>FR</iso> <iso-3166-2>FR-58</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Saône-et-Loire</description> <type>Departement</type> <geoId>4212</geoId> <iso>FR</iso> <iso-3166-2>FR-71</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Territoire de Belfort</description> <type>Departement</type> <geoId>4214</geoId> <iso>FR</iso> <iso-3166-2>FR-90</iso-3166-2> <cities></cities> <children></children> </child> <child> <description>Yonne</description> <type>Departement</type> <geoId>4213</geoId> <iso>FR</iso> <iso-3166-2>FR-89</iso-3166-2> <cities></cities> <children></children> </child> </children> </child> </children> </location> </results> </fcal_api>
Aufruf:
https://www.feiertagskalender.ch/api/GeoTree/ISO/index.php?api_key=YOUR_API_KEY&iso=FR&format=csv
Réponse de l'API :
"location_L0";"type_L0";"geoId_L0";"iso_L0";"iso-3166-2_L0";"location_L1";"type_L1";"geoId_L1";"iso_L1";"iso-3166-2_L1";"location_L2";"type_L2";"geoId_L2";"location_L3";"type_L3";"geoId_L3";"location_L4";"type_L4";"geoId_L4";"cityName";"cityId" "Frankreich";"Land";"3079";"FR";"";"";"";"";"";"";"";"";"";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"";"";"";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Ain";"Departement";"4142";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Allier";"Departement";"4143";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Ardèche";"Departement";"4144";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Cantal";"Departement";"4145";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Drôme";"Departement";"4146";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Haute-Loire";"Departement";"4149";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Haute-Savoie";"Departement";"4154";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Isère";"Departement";"4147";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Loire";"Departement";"4148";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Métropole de Lyon";"Departement";"4152";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Puy-de-Dôme";"Departement";"4150";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Rhône";"Departement";"4151";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Auvergne-Rhône-Alpes";"Region";"3099";"FR";"FR-ARA";"Savoie";"Departement";"4153";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"";"";"";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Côte-d’Or";"Departement";"4207";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Doubs";"Departement";"4208";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Haute-Saône";"Departement";"4211";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Jura";"Departement";"4209";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Nièvre";"Departement";"4210";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Saône-et-Loire";"Departement";"4212";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Territoire de Belfort";"Departement";"4214";"";"";"";"";"";"";"";"" "Frankreich";"Land";"3079";"FR";"";"Bourgogne-Franche-Comté";"Region";"3101";"FR";"FR-BFC";"Yonne";"Departement";"4213";"";"";"";"";"";"";"";""
Emplacement de la sortie | Message d'erreur | Explication |
---|---|---|
results: status: | ||
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é. |