Recupera l'albero geoprafico per tutte le voci disponibili di un paese, in base a un codice paese ISO (iso).
Questa API legge l'albero geografico di un Paese o di una regione. Ciò consente di determinare i geoId necessari per ulteriori interrogazioni. I parametri richiesti sono `api_key` e `iso`. Inoltre, l'output può essere configurato utilizzando altri parametri. I parametri vengono passati come parametri di query nell'URL. In alternativa, l'autorizzazione può avvenire anche nell'intestazione.
**Nota:** L'albero geografico contiene tutte le voci derivanti dalla necessità di visualizzare correttamente i giorni festivi e le vacanze scolastiche. Esiste anche un database delle città separato con altre città che si trovano all'interno della nostra struttura ad albero. Il parametro `città` (0/1) può essere utilizzato per specificare se il database delle città deve essere incluso nell'output dell'albero geografico.
Apre la documentazione interattiva dell'API con Swagger, dove è possibile testare ed esplorare gli endpoint dell'API.
Per recuperare i dati, utilizzare il seguente URL. Si prega di prestare attenzione alle maiuscole e alle minuscole.
https://feiertagskalender.ch/api/GeoTree/ISO/index.php
Con le seguenti variabili è possibile completare la query e controllare i risultati delle API.
| Parametro | Spiegazione | Esempi |
|---|---|---|
| api_key richiesto |
La vostra chiave API | api_key=abc-123-def-456 |
| iso richiesto |
Codice ISO del paese, 2 cifre, o Codice regione secondo ISO 3166-2 |
iso=DE-BW |
| cities | Flag per l'esportazione estesa con le città registrate: Varianti: |
&cities=1 |
| charset | La codifica desiderata della risposta Varianti: |
charset=iso-8859-1 |
| format | Il formato di uscita desiderato Varianti: |
format=xml |
| hl | Lingua desiderata dell'uscita Varianti: |
hl=en |
Il contenuto delle risposte API deriva da:
- i dati che hai sottoscritto (paesi, vacanze, vacanze scolastiche, anni solari)
- i dati ufficialmente noti dei legislatori
- la disponibilità in base alle nostre ricerche (situazione effettiva del nostro database)
Si prega di notare che l'output in formato CSV è diverso.
| Array | Spiegazione | Esempio | ||||
|---|---|---|---|---|---|---|
| interface | Versione dell'API | |||||
| source: | href | URL della fonte dei dati (sito web) | ||||
| description | Nome della fonte dei dati | |||||
| copyright | href | URL al titolare del copyright (sito web) | ||||
| description | Designazione del titolare del diritto d'autore | |||||
| apiName | Identificazione dell'API | GeoTree/ISO | ||||
| apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
| date | Data di esportazione dei dati | 01.03.2026 | ||||
| request: | iso | Codice ISO del paese, 2 cifre | BE | |||
| charset | Codifica dei caratteri di output | utf-8 | ||||
| format | Formato dei dati di uscita | json | ||||
| hl | Lingua di emissione, secondo la richiesta | it | ||||
| results | status | description | Stato dell'output. Per le varianti, vedere i Messaggi di errore | ok | ||
| location | Unità geografica secondo la richiesta | |||||
| description | Nome dell'unità geografica | Belgio | ||||
| type | Designazione del tipo di unità geografica | Paese | ||||
| geoId | Geo-ID dell'unità geografica. | 3285 | ||||
| iso | Codice ISO del paese, 2 cifre | BE | ||||
| iso-3166-2 | Codice regione secondo ISO 3166-2 | |||||
| cities | Tutte le città e i paesi coperti in questa regione | |||||
| description | ||||||
| cityId | ||||||
| children | Eventuali unità geografiche subordinate | |||||
| description | Nome dell'unità geografica | Bruxelles | ||||
| type | Designazione del tipo di unità geografica | Regione | ||||
| geoId | Geo-ID dell'unità geografica. | 3288 | ||||
| iso | Codice ISO del paese, 2 cifre | BE | ||||
| iso-3166-2 | Codice regione secondo ISO 3166-2 | BE-BRU | ||||
| cities | Tutte le città e i paesi coperti in questa regione | |||||
| children | Eventuali unità geografiche subordinate (sono possibili fino a 4 livelli) |
array |
URL:
https://www.feiertagskalender.ch/api/GeoTree/ISO/index.php?api_key=YOUR_API_KEY&iso=FR
Risposta delle 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
Risposta delle 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
Risposta delle 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";"";"";"";"";"";"";"";""
| Posizione di uscita | Messaggio di errore | Spiegazione |
|---|---|---|
| results: status: | ||
| results: status: description | unknown location | Il codice paese ISO richiesto non è noto.
Si prega di controllare il parametro ISO |
| apiStatus | ||
| apiStatus: description | invalid usage | L'uso di questa API non è abilitato per questo utente. |
| apiStatus: description | invalid key | Chiave API non valida. |
| apiStatus: description | invalid referer | Accesso non valido. Non sono ammessi link da pagine web (front-end). |
| apiStatus: description | inactive | L'API non è ancora stata attivata per l'uso. |
| apiStatus: description | expired | Il periodo di utilizzo secondo il contratto è scaduto. |