Documentazione API

Dati annuali

API: Data/LatLon

Ottiene i giorni festivi e le vacanze scolastiche per un anno intero, in base a `lat` e `lon` (geocoordinate).

Funzione

Abilita le query tramite le geocoordinate. Restituisce le vacanze e le vacanze scolastiche del rispettivo comune/regione. Per migliorare i risultati nelle zone periferiche, è possibile inviare anche un codice paese ISO e/o modificare la distanza di ricerca.

Attenzione: La localizzazione viene effettuata tramite misurazione della distanza. Nelle aree periferiche, l'assegnazione può quindi fornire risultati non corretti.


Guida interattiva e OpenAPI aperta

OpenAPI 3.0 (Swagger) – Documentazione API interattiva

Apre la documentazione interattiva dell'API con Swagger, dove è possibile testare ed esplorare gli endpoint dell'API.

Scarica le specifiche JSON di OpenAPI

URL per le richieste

Per recuperare i dati, utilizzare il seguente URL. Si prega di prestare attenzione alle maiuscole e alle minuscole.

POST / GET
https://feiertagskalender.ch/api/Data/LatLon/index.php

Parametri per le richieste

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
lat
richiesto
Latitude. Latitudine geografica lat=46.9576
lon
richiesto
Longitude. Longitudine geografica lon=7.45134
iso Codice ISO del paese, 2 cifre

Informazioni supplementari opzionali per una migliore assegnazione.
iso=CH
dist Distanza massima di ricerca in km

senza specifica: 100km (= Standard)
dist=200
year
o
jahr

Anno delle date richieste

senza specificazione: anno civile corrente (= standard)

year= 2026
class
o
klasse

Portata dei dati

Varianti:
0 = solo vacanze scolastiche
3 = 0 + giorni festivi riconosciuti dalla legge
4 = 0 + 3 + festività pubbliche e non (religiose, culturali) (= Standard)
5 = 0 + 3 + 4 + giorni di evento (ad es. San Valentino, Festa della mamma, Avvento)

klasse=5
charset

La codifica desiderata della risposta

Varianti:
UTF-8 (= Standard)
ISO-8859-1

charset=iso-8859-1
format

Il formato di uscita desiderato

Varianti:
JSON (= Standard)
XML
CSV

format=xml
date_format

Il formato della data desiderato per la risposta. Standard:`Y-m-d` (ad esempio, 2025-12-31).
Il formato corrisponde alla formattazione della data dell'istruzione PHP date()

Varianti:
Y-m-d = YYYY-MM-DD (ISO-8601) (= Standard)
d.m.Y = DD.MM.YYYY
Ymd = YYYYMMDD
dmY = DDMMYYYY
d.m.y = DD.MM.YY
j.n.y = D.M.YY

date_format=d.m.Y
hl

Lingua desiderata dell'uscita

Varianti:
de = Tedesco (= Standard)
fr = Francese
it = Italiano
en = Inglese

hl=en

Esempi (URL / PHP / Python / JavaScript)

Mostra esempi

Valori di ritorno dell'API

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/LatLon
apiStatus description       Designazione dello stato API. Per le varianti, vedere i Messaggi di errore active
date         Data di esportazione dei dati 01.05.2025
request: lat       Latitude. Latitudine geografica 46.9576
  lon       Longitude. Longitudine geografica 7.45134
  iso       Codice ISO del paese, 2 cifre CH
  dist       Distanza massima di ricerca in km 100
  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 Berna
    type     Designazione del tipo di unità geografica Città
    geoId     Geo-ID dell'unità geografica. 410
    iso     Codice ISO del paese, 2 cifre BE
    iso-3166-2     Codice regione secondo ISO 3166-2  
    note     Note speciali
    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  

Esempi (JSON / XML / CSV)

JSON

URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022

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": "Data/LatLon",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "lat": "46.9488",
        "lon": "7.4388",
        "iso": "",
        "dist": "100",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "location": {
            "description": "Bern",
            "type": "Stadt",
            "geoId": "410",
            "iso": "CH",
            "iso-3166-2": "CH-BE",
            "note": "",
            "events": [
                {
                    "description": "Neujahr",
                    "id": "1",
                    "dateStart": "2022-01-01",
                    "dateEnd": "2022-01-01",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Berchtoldstag",
                    "id": "3",
                    "dateStart": "2022-01-02",
                    "dateEnd": "2022-01-02",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Karfreitag",
                    "id": "17",
                    "dateStart": "2022-04-15",
                    "dateEnd": "2022-04-15",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Ostern",
                    "id": "18",
                    "dateStart": "2022-04-17",
                    "dateEnd": "2022-04-17",
                    "class": "4",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Ostermontag",
                    "id": "19",
                    "dateStart": "2022-04-18",
                    "dateEnd": "2022-04-18",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Auffahrt",
                    "id": "31",
                    "dateStart": "2022-05-26",
                    "dateEnd": "2022-05-26",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Pfingsten",
                    "id": "30",
                    "dateStart": "2022-06-05",
                    "dateEnd": "2022-06-05",
                    "class": "4",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Pfingstmontag",
                    "id": "35",
                    "dateStart": "2022-06-06",
                    "dateEnd": "2022-06-06",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Nationalfeiertag Schweiz",
                    "id": "12",
                    "dateStart": "2022-08-01",
                    "dateEnd": "2022-08-01",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Weihnachten",
                    "id": "23",
                    "dateStart": "2022-12-25",
                    "dateEnd": "2022-12-25",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "description": "Stephanstag",
                    "id": "37",
                    "dateStart": "2022-12-26",
                    "dateEnd": "2022-12-26",
                    "class": "2",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Weihnachtsferien",
                    "description": "Weihnachtsferien",
                    "id": "530660",
                    "dateStart": "2021-12-25",
                    "dateEnd": "2022-01-09",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Sportferien",
                    "description": "Sportferien",
                    "id": "531963",
                    "dateStart": "2022-02-05",
                    "dateEnd": "2022-02-13",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": "DIN Woche 6"
                },
                {
                    "name": "Frühlingsferien",
                    "description": "Frühlingsferien",
                    "id": "530661",
                    "dateStart": "2022-04-09",
                    "dateEnd": "2022-04-24",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Auffahrtsferien",
                    "description": "Auffahrtsferien",
                    "id": "732799",
                    "dateStart": "2022-05-26",
                    "dateEnd": "2022-05-29",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Pfingstmontag",
                    "description": "Pfingstmontag",
                    "id": "732800",
                    "dateStart": "2022-06-06",
                    "dateEnd": "2022-06-06",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Sommerferien",
                    "description": "Sommerferien",
                    "id": "530662",
                    "dateStart": "2022-07-09",
                    "dateEnd": "2022-08-14",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Herbstferien",
                    "description": "Herbstferien",
                    "id": "530663",
                    "dateStart": "2022-09-24",
                    "dateEnd": "2022-10-16",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                },
                {
                    "name": "Weihnachtsferien",
                    "description": "Weihnachtsferien",
                    "id": "530664",
                    "dateStart": "2022-12-24",
                    "dateEnd": "2023-01-08",
                    "class": "0",
                    "percent": "100",
                    "prov": "0",
                    "note": null
                }
            ]
        }
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022&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>Data/LatLon</apiName>
<date>2025-02-27</date>
<request>
<lat>46.9488</lat>
<lon>7.4388</lon>
<iso></iso>
<dist>100</dist>
<year>2022</year>
<class>4</class>
<charset>utf-8</charset>
<format>xml</format>
<date_format>Y-m-d</date_format>
<hl>de</hl>
</request>
<results>
<status>
<description>ok</description>
</status>
<location>
<description>Bern</description>
<type>Stadt</type>
<geoId>410</geoId>
<iso>CH</iso>
<iso-3166-2>CH-BE</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrt</description>
<id>31</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-26</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingsten</description>
<id>30</id>
<dateStart>2022-06-05</dateStart>
<dateEnd>2022-06-05</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingstmontag</description>
<id>35</id>
<dateStart>2022-06-06</dateStart>
<dateEnd>2022-06-06</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Nationalfeiertag Schweiz</description>
<id>12</id>
<dateStart>2022-08-01</dateStart>
<dateEnd>2022-08-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Weihnachten</description>
<id>23</id>
<dateStart>2022-12-25</dateStart>
<dateEnd>2022-12-25</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Stephanstag</description>
<id>37</id>
<dateStart>2022-12-26</dateStart>
<dateEnd>2022-12-26</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Weihnachtsferien</description>
<id>530660</id>
<dateStart>2021-12-25</dateStart>
<dateEnd>2022-01-09</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sportferien</description>
<id>531963</id>
<dateStart>2022-02-05</dateStart>
<dateEnd>2022-02-13</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note>DIN Woche 6</note>
</event>
<event>
<description>Frühlingsferien</description>
<id>530661</id>
<dateStart>2022-04-09</dateStart>
<dateEnd>2022-04-24</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrtsferien</description>
<id>732799</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-29</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingstmontag</description>
<id>732800</id>
<dateStart>2022-06-06</dateStart>
<dateEnd>2022-06-06</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sommerferien</description>
<id>530662</id>
<dateStart>2022-07-09</dateStart>
<dateEnd>2022-08-14</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Herbstferien</description>
<id>530663</id>
<dateStart>2022-09-24</dateStart>
<dateEnd>2022-10-16</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Weihnachtsferien</description>
<id>530664</id>
<dateStart>2022-12-24</dateStart>
<dateEnd>2023-01-08</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
</results>
</fcal_api>

CSV

URL:
https://www.feiertagskalender.ch/api/Data/LatLon/index.php?api_key=YOUR_API_KEY&lat=46.9488&lon=7.4388&year=2022&format=csv

Risposta delle API:

"location";"geoId";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Bern";"410";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Bern";"410";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Bern";"410";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Bern";"410";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Bern";"410";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Bern";"410";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";""
"Bern";"410";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Bern";"410";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";""
"Bern";"410";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";""
"Bern";"410";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";""
"Bern";"410";"Stephanstag";"37";"2022-12-26";"2022-12-26";"2";"100";"0";""
"Bern";"410";"Weihnachtsferien";"530660";"2021-12-25";"2022-01-09";"0";"100";"0";""
"Bern";"410";"Sportferien";"531963";"2022-02-05";"2022-02-13";"0";"100";"0";"DIN Woche 6"
"Bern";"410";"Frühlingsferien";"530661";"2022-04-09";"2022-04-24";"0";"100";"0";""
"Bern";"410";"Auffahrtsferien";"732799";"2022-05-26";"2022-05-29";"0";"100";"0";""
"Bern";"410";"Pfingstmontag";"732800";"2022-06-06";"2022-06-06";"0";"100";"0";""
"Bern";"410";"Sommerferien";"530662";"2022-07-09";"2022-08-14";"0";"100";"0";""
"Bern";"410";"Herbstferien";"530663";"2022-09-24";"2022-10-16";"0";"100";"0";""
"Bern";"410";"Weihnachtsferien";"530664";"2022-12-24";"2023-01-08";"0";"100";"0";""

Messaggi di errore

Posizione di uscita Messaggio di errore Spiegazione
results: status:
results: status: description not subscribed Non avete sottoscritto i dati desiderati.
results: status: description unknown location Non è stato possibile assegnare le coordinate richieste.
Le coordinate sono al di fuori dell'area catturata, o non sono valide.
Si prega di controllare i parametri lat e lon.
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.
© 2003 - 2025 psc Peter Schütz Informatik Dienstleistungen, CH-Arch