Set di dati con le vacanze e le vacanze scolastiche di un anno.
Capitoli:
Attiva le interrogazioni tramite City-ID (ID di Feiertagskalender.ch). Fornisce i dati dell'anno civile (giorni festivi e vacanze scolastiche) dall'1.01. al 31.12. di un anno.
I City-ID disponibili si trovano nell'API:GeoTree/ISO
Per recuperare i dati, utilizzare il seguente URL. Si prega di prestare attenzione alle maiuscole e alle minuscole.
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 |
cityId richiesto |
City-ID della località desiderata. Il City-ID di Feiertagskalender.ch | &cityid=88 |
year o jahr |
Anno delle date richieste |
&year= 2025 |
class o klasse |
Portata dei dati Varianti: |
&klasse=5 |
charset | La codifica desiderata della risposta Varianti: |
&charset=iso-8859-1 |
format | Il formato di uscita desiderato Varianti: |
&format=xml |
date_format | Il formato di data desiderato Varianti: |
&date_format=d.m.Y |
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 | Data/CityId | ||||
apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
date | Data di esportazione dei dati | 18.04.2024 | ||||
request: | cityId | City-ID secondo la richiesta | 88 | |||
year | Anno dei dati nell'output | 2015 | ||||
class | Classe della query (riguarda la portata dei dati) | 4 | ||||
charset | Codifica dei caratteri di output | utf-8 | ||||
format | Formato dei dati di uscita | json | ||||
date_format | Formato data dell'output | d.m.Y | ||||
hl | Lingua di emissione, secondo la richiesta | it | ||||
results | status | description | Stato dell'output. Per le varianti, vedere i Messaggi di errore | ok | ||
location | description | Nome dell'unità geografica | Berlin | |||
cityId | Geo-ID dell'unità geografica. | 88 | ||||
iso | Codice ISO del paese, 2 cifre | DE | ||||
iso-3166-2 | Codice regione secondo ISO 3166-2 | DE-BE | ||||
note | Note speciali | NUOVO 30.03.2023 | ||||
events | Gli eventi del calendario | |||||
description | Designazione della festa, o delle vacanze scolastiche | Capodanno | ||||
id | ID unica dell'evento. Le feste hanno la stessa ID ogni anno. Le vacanze scolastiche hanno tutti un proprio ID. | 1 | ||||
dateStart | Data Inizio dell'evento | 01.01.2015 | ||||
dateEnd | Data Fine dell'evento | 01.01.2015 | ||||
class | Classe dell'evento: 0 = Vacanze scolastiche 1 = giorno festivo riconosciuto legalmente 2 = Giorno festivo alla pari della domenica 3 = giorno di riposo ufficiale (di solito da mezzogiorno) 4 = giorno festivo non riconosciuto legalmente (negozi, scuole, amministrazioni solitamente chiuse), giorno festivo; ai fini della Convenzione europea sul calcolo dei termini, questo giorno è considerato come un giorno festivo (articolo 5). 5 = Giorno evento # = parzialmente valido |
2 | ||||
percent | Percentuale di abitanti / classi scolastiche interessate | 100 | ||||
prov | Flag per dati definiti provvisoriamente 0 = sicuramente 1 = provvisorio |
0 | ||||
note | note speciali |
Posizione di uscita | Messaggio di errore | Spiegazione |
---|---|---|
results: status: | ||
results: status: description | not subscribed | Non avete sottoscritto i dati desiderati. Si prega di contattare il nostro supporto. |
results: status: description | unknown location | Il City-ID richiesto non è noto. Si prega di controllare il parametro cityId |
apiStatus | ||
apiStatus: description | invalid usage | L'uso di questa API non è sbloccato per voi. Si prega di contattare il nostro supporto. |
apiStatus: description | invalid key | Chiave API non valida. Si prega di controllare la chiave API. |
apiStatus: description | invalid referer | Accesso non valido. Non sono ammessi link da pagine web (front-end). Impostate la vostra richiesta in modo che provenga da un back-end protetto. Se necessario, contattare il nostro supporto. |
apiStatus: description | inactive | L'API non è ancora stata abilitata all'uso. Si prega di riprovare in un secondo momento. |
apiStatus: description | expired | Il periodo di utilizzo secondo il contratto è scaduto. Contattate la nostra amministrazione per un prolungamento del contratto. |
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&jahr=2015&date_format=d.m.Y&CityId=88
Risposta delle API:
{ "interface": "fcal API 2.0", "source": { "href": "https://feiertagskalender.ch", "description": "feiertagskalender.ch" }, "copyright": { "href": "https://psc.ch", "description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Bern" }, "apiName": "Data/CityId", "apiStatus": { "description": "active" }, "date": "04.08.2017", "request": { "cityId": "88", "year": "2015", "class": "4", "charset": "utf-8", "format": "json", "hl": "de" }, "results": { "status": { "description": "ok" }, { "location": { "description": "Berlin", "cityId": "88", "iso": "DE", "iso-3166-2": "DE-BE", "events": [{ "description": "Neujahrstag", "id": "1", "dateStart": "01.01.2015", "dateEnd": "01.01.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Karfreitag", "id": "17", "dateStart": "03.04.2015", "dateEnd": "03.04.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Ostern", "id": "18", "dateStart": "05.04.2015", "dateEnd": "05.04.2015", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Ostermontag", "id": "19", "dateStart": "06.04.2015", "dateEnd": "06.04.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Tag der Arbeit", "id": "22", "dateStart": "01.05.2015", "dateEnd": "01.05.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Christi Himmelfahrt", "id": "31", "dateStart": "14.05.2015", "dateEnd": "14.05.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingsten", "id": "30", "dateStart": "24.05.2015", "dateEnd": "24.05.2015", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingstmontag", "id": "35", "dateStart": "25.05.2015", "dateEnd": "25.05.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Tag der Deutschen Einheit", "id": "92", "dateStart": "03.10.2015", "dateEnd": "03.10.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Volkstrauertag", "id": "216", "dateStart": "15.11.2015", "dateEnd": "15.11.2015", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachten", "id": "23", "dateStart": "25.12.2015", "dateEnd": "25.12.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Zweiter Weihnachtsfeiertag", "id": "37", "dateStart": "26.12.2015", "dateEnd": "26.12.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "119140", "dateStart": "22.12.2014", "dateEnd": "2.01.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Winterferien", "id": "119141", "dateStart": "2.02.2015", "dateEnd": "7.02.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Osterferien", "id": "119142", "dateStart": "30.03.2015", "dateEnd": "11.04.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Ferientag", "id": "119143", "dateStart": "15.05.2015", "dateEnd": "15.05.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Ferientag", "id": "119144", "dateStart": "15.07.2015", "dateEnd": "15.07.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sommerferien", "id": "119145", "dateStart": "16.07.2015", "dateEnd": "28.08.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Herbstferien", "id": "119146", "dateStart": "19.10.2015", "dateEnd": "31.10.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "119147", "dateStart": "23.12.2015", "dateEnd": "2.01.2016", "class": "0", "percent": "100", "prov": "0", "note": null }] } } }
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&jahr=2015&charset=iso-8859-1&date_format=d.m.Y&CityId=88&format=xml
Risposta delle API:
<fcal_api> <interface>fcal API 2.0</interface> <source> <href>https://feiertagskalender.ch</href> <description>feiertagskalender.ch</description> </source> <copyright> <href>https://psc.ch</href> <description>psc Peter Schuetz Informatik-Dienstleistungen, CH Bern</description> </copyright> <apiStatus> <description>active</description> </apiStatus> <apiName>Data/CityId</apiName> <date>04.08.2017</date> <request> <cityId>88</cityId> <year>2015</year> <class>4</class> <charset>utf-8</charset> <format>xml</format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Berlin</description> <cityId>88</cityId> <iso>DE</iso> <iso-3166-2>DE-BE</iso-3166-2> <events> <event> <description>Neujahrstag</description> <id>1</id> <dateStart>01.01.2015</dateStart> <dateEnd>01.01.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Karfreitag</description> <id>17</id> <dateStart>03.04.2015</dateStart> <dateEnd>03.04.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostern</description> <id>18</id> <dateStart>05.04.2015</dateStart> <dateEnd>05.04.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ostermontag</description> <id>19</id> <dateStart>06.04.2015</dateStart> <dateEnd>06.04.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Tag der Arbeit</description> <id>22</id> <dateStart>01.05.2015</dateStart> <dateEnd>01.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Christi Himmelfahrt</description> <id>31</id> <dateStart>14.05.2015</dateStart> <dateEnd>14.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingsten</description> <id>30</id> <dateStart>24.05.2015</dateStart> <dateEnd>24.05.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingstmontag</description> <id>35</id> <dateStart>25.05.2015</dateStart> <dateEnd>25.05.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Tag der Deutschen Einheit</description> <id>92</id> <dateStart>03.10.2015</dateStart> <dateEnd>03.10.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Volkstrauertag</description> <id>216</id> <dateStart>15.11.2015</dateStart> <dateEnd>15.11.2015</dateEnd> <class>4</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachten</description> <id>23</id> <dateStart>25.12.2015</dateStart> <dateEnd>25.12.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Zweiter Weihnachtsfeiertag</description> <id>37</id> <dateStart>26.12.2015</dateStart> <dateEnd>26.12.2015</dateEnd> <class>1</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>119140</id> <dateStart>22.12.2014</dateStart> <dateEnd>2.01.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Winterferien</description> <id>119141</id> <dateStart>2.02.2015</dateStart> <dateEnd>7.02.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Osterferien</description> <id>119142</id> <dateStart>30.03.2015</dateStart> <dateEnd>11.04.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ferientag</description> <id>119143</id> <dateStart>15.05.2015</dateStart> <dateEnd>15.05.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Ferientag</description> <id>119144</id> <dateStart>15.07.2015</dateStart> <dateEnd>15.07.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sommerferien</description> <id>119145</id> <dateStart>16.07.2015</dateStart> <dateEnd>28.08.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Herbstferien</description> <id>119146</id> <dateStart>19.10.2015</dateStart> <dateEnd>31.10.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>119147</id> <dateStart>23.12.2015</dateStart> <dateEnd>2.01.2016</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> </events> </location> </results> </fcal_api>
URL:
https://feiertagskalender.ch/api/Data/CityId/?api_key=YOUR_API_KEY&charset=iso-8859-1&jahr=2015&date_format=d.m.Y&cityId=88&format=csv
Risposta delle API:
"location";"cityId";"iso";"iso-3166-2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note" "Berlin";"88";"DE";"DE-BE";"Neujahrstag";"1";"01.01.2015";"01.01.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Karfreitag";"17";"03.04.2015";"03.04.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Ostern";"18";"05.04.2015";"05.04.2015";"4";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Ostermontag";"19";"06.04.2015";"06.04.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Tag der Arbeit";"22";"01.05.2015";"01.05.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Christi Himmelfahrt";"31";"14.05.2015";"14.05.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Pfingsten";"30";"24.05.2015";"24.05.2015";"4";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Pfingstmontag";"35";"25.05.2015";"25.05.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Tag der Deutschen Einheit";"92";"03.10.2015";"03.10.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Volkstrauertag";"216";"15.11.2015";"15.11.2015";"4";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Weihnachten";"23";"25.12.2015";"25.12.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Zweiter Weihnachtsfeiertag";"37";"26.12.2015";"26.12.2015";"1";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Weihnachtsferien";"119140";"22.12.2014";"2.01.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Winterferien";"119141";"2.02.2015";"7.02.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Osterferien";"119142";"30.03.2015";"11.04.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Ferientag";"119143";"15.05.2015";"15.05.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Ferientag";"119144";"15.07.2015";"15.07.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Sommerferien";"119145";"16.07.2015";"28.08.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Herbstferien";"119146";"19.10.2015";"31.10.2015";"0";"100";"0";"" "Berlin";"88";"DE";"DE-BE";"Weihnachtsferien";"119147";"23.12.2015";"2.01.2016";"0";"100";"0";""