Informazioni giornaliere per sapere se in questa data ci sono giorni festivi e/o vacanze scolastiche.
Capitoli:
Attiva le interrogazioni tramite Geo-ID (ID di Feiertagskalender.ch) e data. Indica se e a quale percentuale si applica un giorno festivo in questo giorno, o le vacanze scolastiche.
I Geo-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 |
geoId richiesto |
Geo-ID della località desiderata. Il Geo-ID di Feiertagskalender.ch | &geoid=88 |
date | Data dei dati richiesti |
&date=2024-05-25 |
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 | CheckDate/GeoId | ||||
apiStatus | description | Designazione dello stato API. Per le varianti, vedere i Messaggi di errore | active | |||
date | Data di esportazione dei dati | 25.04.2024 | ||||
request: | geoId | Geo-ID secondo la richiesta | 410 | |||
date | Data dei dati nell'output | 2019-02-28 | ||||
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 | Zurigo | |||
type | Designazione del tipo di unità geografica | Cantone | ||||
geoId | Geo-ID dell'unità geografica. | 2872 | ||||
iso | Codice ISO del paese, 2 cifre | CH | ||||
iso-3166-2 | Codice regione secondo ISO 3166-2 | CH-ZH | ||||
note | Note speciali | NUOVO 30.03.2023 | ||||
date_status | Stato del giorno | |||||
date | Data | 2019-02-28 | ||||
total_population | Numero totale di abitanti | 1502167 | ||||
public_holiday_population | Numero di abitanti con giorni festivi | 0 | ||||
public_holiday_percent | Percentuale di abitanti con giorni festivi | 0 | ||||
public_holiday_description | Designazione della festa | |||||
school_holiday_population | Numero di abitanti con vacanze scolastiche | 501752 | ||||
school_holiday_percent | Percentuale di popolazione con vacanze scolastiche | 33.4018787524955 | ||||
school_holiday_description | Designazione Vacanze scolastiche | Sportferien | ||||
sum_population | Numero totale di abitanti interessati | 501752 | ||||
percent_population | Percentuale di abitanti interessati | 33.4018787524955 |
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 Geo-ID richiesto non è noto. Si prega di controllare il parametro geoId |
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/CheckDate/GeoId/?api_key=YOUR_API_KEY&geoId=2872&date=2019-02-28
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":"CheckDate/GeoId", "apiStatus":{ "description":"active" }, "date":"2024-04-25", "request":{ "geoId":"2872", "date":"2019-02-28", "charset":"utf-8", "format":"json", "date_format":"Y-m-d", "hl":"de" }, "results":{ "status":{ "description":"ok" }, "location":{ "description":"Zürich", "type":"Kanton", "geoId":"2872", "iso":"CH", "iso-3166-2":"CH-ZH", "date_status":{ "date":"2019-02-28", "total_population":1502167, "public_holiday_population":0, "public_holiday_percent":0, "public_holiday_description":null, "school_holiday_population":501752, "school_holiday_percent":33.401878752495563, "school_holiday_description":"Sportferien", "sum_population":501752, "sum_percent":33.401878752495563 } } } }
URL:
https://feiertagskalender.ch/api/CheckDate/GeoId/?api_key=YOUR_API_KEY&charset=iso-8859-1&geoId=2872&date=2019-02-28&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>CheckDate/GeoId</apiName> <date>2024-04-25</date> <request> <geoId>2872</geoId> <date>2019-02-28</date> <charset>iso-8859-1</charset> <format>xml</format> <date_format>Y-m-d</date_format> <hl>de</hl> </request> <results> <status> <description>ok</description> </status> <location> <description>Zürich</description> <type>Kanton</type> <geoId>2872</geoId> <iso>CH</iso> <iso-3166-2>CH-ZH</iso-3166-2> <date_status> <date>2019-02-28</date> <total_population>1502167</total_population> <public_holiday_population>0</public_holiday_population> <public_holiday_percent>0</public_holiday_percent> <public_holiday_description></public_holiday_description> <school_holiday_population>501752</school_holiday_population> <school_holiday_percent>33.401878752496</school_holiday_percent> <school_holiday_description>Sportferien</school_holiday_description> <sum_population>501752</sum_population> <sum_percent>33.401878752496</sum_percent> </date_status> </location> </results> </fcal_api>
URL:
https://feiertagskalender.ch/api/Data/GeoId/?api_key=YOUR_API_KEY&charset=iso-8859-1&jahr=2015&date_format=d.m.Y&geoId=410&format=csv
Risposta delle API:
"location";"geoId";"iso";"iso-3166-2";"date";"total_population";"public_holiday_population";"public_holiday_percent";"public_holiday_description";"school_holiday_population";"school_holiday_percent";"school_holiday_description";"sum_population";"sum_percent" "Zürich";"2872";"CH";"CH-ZH";"2019-02-28";"1502167";"0";"0";"";"501752";"33.401878752496";"Sportferien";"501752";"33.401878752496"