Documentazione API

Dati annuali

Leggere i dati annuali di diverse località

Paesi e regioni che utilizzano il codice paese ISO Tutti i comuni della Svizzera, compresi i numeri UFS

Tutti i codici postali Svizzera, compresi i numeri UFS

Tutti i comuni per 1 cantone svizzero

Tutti i comuni della Liechtenstein, compresi i numeri UFS

Tutti i codici postali del Liechtenstein, compresi i numeri UFS

Tutti i comuni della Svezia (compresi i codici dei comuni).

API: Data/Country/CH

Ottenere i giorni festivi e le vacanze scolastiche per un anno intero per tutti i comuni della Svizzera.

Funzione

Questa API determina per tutti i **comuni della Svizzera** in quali giorni dell'anno si svolgono i giorni festivi ufficiali o le vacanze scolastiche. I dati contengono anche il numero del comune dell'UST. Il parametro richiesto è `api_key`. Il parametro `anno` è opzionale: se non viene specificato, viene utilizzato automaticamente l'anno corrente. L'output può essere configurato anche con parametri aggiuntivi. I parametri vengono trasferiti come JSON nel corpo della richiesta. In alternativa, l'autorizzazione può avvenire anche nell'intestazione.

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/Country/CH/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
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

Parametri nell'URL

I parametri possono essere inclusi nell'URL (ad esempio, tramite il browser o in Excel):
Nota: Il primo parametro è introdotto con ?, tutti gli altri parametri sono introdotti con &.

Importante: questo codice non deve essere utilizzato direttamente in un sito web! Per motivi di sicurezza, le chiavi API devono essere elaborate solo nel backend.

https://feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&year=2022

Esempio PHP con cURL (GET)

$api_url = "https://feiertagskalender.ch/api/Data/Country/CH/index.php?year=2022";
$api_key = "YOUR_API_KEY";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
   "Authorization: Bearer $api_key",
   "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

Esempio PHP con cURL (POST)

$api_url = "https://feiertagskalender.ch/api/Data/Country/CH/index.php";
$api_key = "YOUR_API_KEY";

// POST-Daten
$post_data = json_encode([
    "year": "2022"	
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $api_key",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Esempio Python con requests (GET)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/Data/Country/CH/index.php?year=2022"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get(api_url, headers=headers)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Esempio Python con requests (POST)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/Data/Country/CH/index.php"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

payload = {
    "year": "2022"	
}

response = requests.post(api_url, headers=headers, json=payload)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Esempio JavaScript con Fetch API (GET)

L'API Fetch è un metodo moderno per eseguire richieste HTTP in JavaScript. È supportata dai browser attuali.

Importante: questo codice non deve essere utilizzato direttamente in un sito web! Per motivi di sicurezza, le chiavi API devono essere elaborate solo nel backend.

const apiUrl = "https://feiertagskalender.ch/api/Data/Country/CH/index.php?year=2022";
const apiKey = "YOUR_API_KEY";  								
const headers = new Headers({
    "Authorization": "Bearer " + apiKey,
    "Content-Type": "application/json"
});

fetch(apiUrl, { method: "GET", headers })
    .then(response => {
        if (!response.ok) {
            throw new Error(`Error: ${response.status} ${response.statusText}`);
        }
        return response.json();
    })
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));

Esempio JavaScript con Fetch API (POST)

L'API Fetch è un metodo moderno per eseguire richieste HTTP in JavaScript. È supportata dai browser attuali.

const apiUrl = "https://feiertagskalender.ch/api/Data/Country/CH/index.php";
const apiKey = "YOUR_API_KEY";  
const requestData = {
    "year": "2022"	
};

fetch(apiUrl, {
    method: "POST",
    headers: {
        "Authorization": "Bearer " + apiKey,
        "Content-Type": "application/json"
    },
    body: JSON.stringify(requestData)
})
.then(response => {
    if (!response.ok) {
        throw new Error(`Error: ${response.status} ${response.statusText}`);
    }
    return response.json();
})
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

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/Country/CH
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:	iso				Codice ISO del paese, 2 cifre	CH
	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	Aardorf
			type		Designazione del tipo di unità geografica	Comune
			geoId		Geo-ID dell'unità geografica.	2200
			bfsNr		Numero comunità UFS	4551
			iso		Codice ISO del paese, 2 cifre	CH
			iso-3166-2		Codice regione secondo ISO 3166-2	CH-TG
			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/Country/CH/index.php?api_key=YOUR_API_KEY&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/Country/CH",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "iso": "CH",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "locations": [
            {
                "description": "Aadorf",
                "type": "Gemeinde",
                "geoId": "2200",
                "bfsNr": "4551",
                "iso": "CH",
                "iso-3166-2": "CH-TG",
                "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": "Aarau",
                "type": "Gemeinde",
                "geoId": "3",
                "bfsNr": "4001",
                "iso": "CH",
                "iso-3166-2": "CH-AG",
                "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": "Aarberg",
                "type": "Gemeinde",
                "geoId": "371",
                "bfsNr": "301",
                "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
                    }
                ]
            }
        ]
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&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/Country/CH</apiName>
<date>2025-02-27</date>
<request>
<iso>CH</iso>
<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>
<locations>
<location>
<description>Aadorf</description>
<type>Gemeinde</type>
<geoId>2200</geoId>
<bfsNr>4551</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-TG</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>
</events>
</location>
<location>
<description>Aarau</description>
<type>Gemeinde</type>
<geoId>3</geoId>
<bfsNr>4001</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-AG</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>
</events>
</location>
<location>
<description>Aarberg</description>
<type>Gemeinde</type>
<geoId>371</geoId>
<bfsNr>301</bfsNr>
<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>
</events>
</location>
</locations>
</results>
</fcal_api>

CSV

Aufruf:
https://www.feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&year=2022&format=csv

Risposta delle API:

"location";"geoId";"bfsNr";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Aadorf";"2200";"4551";"CH";"CH-TG";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"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.
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.

Area sviluppatori

Dati annuali

Leggere i dati annuali di diverse località

API: Data/Country/CH

Funzione

Guida interattiva e OpenAPI aperta

Capitoli API

URL per le richieste

Parametri per le richieste

Esempi (URL / PHP / Python / JavaScript)

Valori di ritorno dell'API

Esempi (JSON / XML / CSV)

JSON

XML

CSV

Messaggi di errore

Pagine

altro da psc Informatik

Feiertagskalender.ch

Supportare il calendario dei giorni festivi