Leggere i dati annuali di tutte le unità di un paese.
Capitoli:
Abilita le query di un paese, secondo l'abbreviazione ISO del paese. Produce tutte le unità geografiche registrate di un paese, con le relative vacanze e le vacanze scolastiche, dall'1.01. al 31.12. di un anno. Non contiene numeri comunali (CH, LI, NO).
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 |
iso richiesto |
Codice ISO del paese, 2 cifre |
&iso=DE |
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/Country | ||||
apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
date | Data di esportazione dei dati | 26.04.2024 | ||||
request: | iso | Codice ISO del paese, 2 cifre | DE | |||
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 | ||
locations | location | description | Nome dell'unità geografica | Baden-Württemberg | ||
type | Designazione del tipo di unità geografica | Stato | ||||
geoId | Geo-ID dell'unità geografica. | 3060 | ||||
iso | Codice ISO del paese, 2 cifre | DE | ||||
iso-3166-2 | Codice regione secondo ISO 3166-2 | DE-BW | ||||
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 codice paese ISO richiesto non è noto.
Si prega di controllare il parametro ISO |
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/Country/?api_key=YOUR_API_KEY&jahr=2015&class=ç&date_format=d.m.Y&iso=DE
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/Country", "apiStatus": { "description": "active" }, "date": "13.03.2019", "request": { "iso": "DE", "year": "2015", "class": "4", "charset": "utf-8", "format": "json", "date_format": "d.m.Y", "hl": "de" }, "results": { "status": { "description": "ok" }, "locations": [{ "description": "Baden-Württemberg", "type": "Bundesland", "geoId": "3060", "iso": "DE", "iso-3166-2": "DE-BW", "events": [{ "description": "Neujahr", "id": "1", "dateStart": "01.01.2015", "dateEnd": "01.01.2015", "class": "1", "percent": "100", "prov": "0", "note": null }, { "description": "Heilige drei Könige", "id": "4", "dateStart": "06.01.2015", "dateEnd": "06.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": "Fronleichnam", "id": "38", "dateStart": "04.06.2015", "dateEnd": "04.06.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": "Allerheiligen", "id": "47", "dateStart": "01.11.2015", "dateEnd": "01.11.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": "243767", "dateStart": "22.12.2014", "dateEnd": "05.01.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Osterferien", "id": "243768", "dateStart": "30.03.2015", "dateEnd": "10.04.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingstferien", "id": "243769", "dateStart": "26.05.2015", "dateEnd": "06.06.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sommerferien", "id": "248076", "dateStart": "30.07.2015", "dateEnd": "12.09.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Herbstferien", "id": "291421", "dateStart": "31.10.2015", "dateEnd": "06.11.2015", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "291418", "dateStart": "23.12.2015", "dateEnd": "09.01.2016", "class": "0", "percent": "100", "prov": "0", "note": null }] }, { "description": "Bayern", "type": "Freistaat", "geoId": "3061", "iso": "DE", "iso-3166-2": "DE-BY", "events": [{ ... }] }] } }
URL:
https://feiertagskalender.ch/api/Data/Country/?api_key=YOUR_API_KEY&jahr=2015&charset=ISO-8859-1&date_format=d.m.Y&format=xml&iso=DE
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/Country</apiName> <date>13.03.2019</date> <request> <iso>DE</iso> <year>2015</year> <class>4</class> <charset>utf-8</charset> <format>xml</format> <date_format>d.m.Y</date_format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <locations> <location> <description>Baden-Württemberg</description> <type>Bundesland</type> <geoId>3060</geoId> <iso>DE</iso> <iso-3166-2>DE-BW</iso-3166-2> <events> <event> <description>Neujahr</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>Heilige drei Könige</description> <id>4</id> <dateStart>06.01.2015</dateStart> <dateEnd>06.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>Fronleichnam</description> <id>38</id> <dateStart>04.06.2015</dateStart> <dateEnd>04.06.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>Allerheiligen</description> <id>47</id> <dateStart>01.11.2015</dateStart> <dateEnd>01.11.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>243767</id> <dateStart>22.12.2014</dateStart> <dateEnd>05.01.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Osterferien</description> <id>243768</id> <dateStart>30.03.2015</dateStart> <dateEnd>10.04.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Pfingstferien</description> <id>243769</id> <dateStart>26.05.2015</dateStart> <dateEnd>06.06.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Sommerferien</description> <id>248076</id> <dateStart>30.07.2015</dateStart> <dateEnd>12.09.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Herbstferien</description> <id>291421</id> <dateStart>31.10.2015</dateStart> <dateEnd>06.11.2015</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> <event> <description>Weihnachtsferien</description> <id>291418</id> <dateStart>23.12.2015</dateStart> <dateEnd>09.01.2016</dateEnd> <class>0</class> <percent>100</percent> <prov>0</prov> <note></note> </event> </events> </location> <location> <description>Bayern</description> <type>Freistaat</type> <geoId>3061</geoId> <iso>DE</iso> <iso-3166-2>DE-BY</iso-3166-2> <events> ... </events> </location> </locations> </results> </fcal_api>
Aufruf:
https://feiertagskalender.ch/api/Data/Country/?api_key=YOUR_API_KEY&charset=iso-8859-1&iso=DE&jahr=2015&format=csv
Risposta delle API:
"location";"geoId";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note" "Baden-Württemberg";"3060";"DE";"DE-BW";"Neujahr";"1";"01.01.2015";"01.01.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Heilige drei Könige";"4";"06.01.2015";"06.01.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Karfreitag";"17";"03.04.2015";"03.04.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Ostern";"18";"05.04.2015";"05.04.2015";"4";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Ostermontag";"19";"06.04.2015";"06.04.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Tag der Arbeit";"22";"01.05.2015";"01.05.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Christi Himmelfahrt";"31";"14.05.2015";"14.05.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Pfingsten";"30";"24.05.2015";"24.05.2015";"4";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Pfingstmontag";"35";"25.05.2015";"25.05.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Fronleichnam";"38";"04.06.2015";"04.06.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Tag der Deutschen Einheit";"92";"03.10.2015";"03.10.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Allerheiligen";"47";"01.11.2015";"01.11.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Volkstrauertag";"216";"15.11.2015";"15.11.2015";"4";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Weihnachten";"23";"25.12.2015";"25.12.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Zweiter Weihnachtsfeiertag";"37";"26.12.2015";"26.12.2015";"1";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Weihnachtsferien";"243767";"22.12.2014";"05.01.2015";"0";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Osterferien";"243768";"30.03.2015";"10.04.2015";"0";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Pfingstferien";"243769";"26.05.2015";"06.06.2015";"0";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Sommerferien";"248076";"30.07.2015";"12.09.2015";"0";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Herbstferien";"291421";"31.10.2015";"06.11.2015";"0";"100";"0";"" "Baden-Württemberg";"3060";"DE";"DE-BW";"Weihnachtsferien";"291418";"23.12.2015";"09.01.2016";"0";"100";"0";"" "Bayern";"3061";"DE";"DE-BY";"Neujahr";"1";"01.01.2015";"01.01.2015";"1";"100";"0";"" ...