{
"openapi": "3.0.0",
"info": {
"title": "Feiertagskalender API",
"description": "Questa API controlla lo stato della chiave API. Il parametro richiesto è `api_key`. Inoltre, l'output può essere configurato utilizzando altri parametri. I parametri vengono passati come parametri di query nell'URL. In alternativa, l'autorizzazione può avvenire anche nell'intestazione.
**Nota: ** L'output CSV contiene una struttura tabellare piatta in cui gli elementi JSON\/XML annidati non sono mappati. Alcuni campi di dati non sono disponibili in formato CSV.",
"version": "0.9.0"
},
"servers": [
{
"url": "https:\/\/feiertagskalender.ch\/api"
}
],
"paths": {
"\/api_key\/index.php": {
"get": {
"tags": [
"Controllo delle funzioni API"
],
"summary": "Questa API controlla lo stato della chiave API. ",
"description": "**api_key** Questa API controlla lo stato della chiave API. Il parametro richiesto è `api_key`. Inoltre, l'output può essere configurato utilizzando altri parametri. I parametri vengono passati come parametri di query nell'URL. In alternativa, l'autorizzazione può avvenire anche nell'intestazione.",
"parameters": [
{
"name": "api_key",
"in": "query",
"required": true,
"description": "La vostra chiave API",
"schema": {
"type": "string"
}
},
{
"name": "format",
"in": "query",
"required": false,
"description": "Il formato di uscita desiderato",
"schema": {
"type": "string",
"enum": [
"json",
"xml",
"csv"
],
"default": "json"
}
},
{
"name": "date_format",
"in": "query",
"required": false,
"description": "Il formato della data desiderato per la risposta. Standard:`Y-m-d` (ad esempio, 2025-12-31).",
"schema": {
"type": "string",
"enum": [
"Y-m-d",
"d.m.Y",
"dmY",
"Ymd",
"d.n.y",
"j.n.y"
],
"default": "Y-m-d"
}
}
],
"responses": {
"200": {
"description": "Risposta di successo con i risultati della query. L'output CSV contiene una struttura tabellare piatta in cui gli elementi JSON\/XML annidati non sono mappati. Si noti che alcuni campi di dati non sono disponibili in formato CSV. \n\n**JSON-Request:**\n`https:\/\/feiertagskalender.ch\/api\/api_key\/index.php?api_key=YOUR_API_KEY`\n\n**XML-Request:**\n`https:\/\/feiertagskalender.ch\/api\/api_key\/index.php?api_key=YOUR_API_KEY&format=XML`\n\n**CSV-Request:**\n`https:\/\/feiertagskalender.ch\/api\/api_key\/index.php?api_key=YOUR_API_KEY&format=CSV`\n\n",
"content": {
"application\/json": {
"example": {
"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 Arch"
},
"apiName": "api_key",
"date": "2025-02-26",
"apiKeyStatus": "active",
"apiDateStart": "2021-03-31",
"apiDateEnd": "2026-03-31",
"apiData": {
"dataPublicHolidays": "AT,CH,DE,LI",
"yearsPublicHolidays": "2020,2021,2022,2023,2024,2025,2026",
"dataSchoolHolidays": "AT,CH,DE,LI",
"yearsSchoolHolidays": "2020,2021,2022,2023,2024,2025,2026"
},
"apiList": [
{
"api": "api_key"
},
{
"api": "CheckDate\/CH\/BFS"
},
{
"api": "CheckDate\/CH\/PLZ"
},
{
"api": "CheckDate\/GeoId"
},
{
"api": "Data\/Aggreg"
},
{
"api": "Data\/CH\/BFS"
},
{
"api": "Data\/CH\/Kanton"
},
{
"api": "Data\/CH\/PLZ"
},
{
"api": "Data\/Country"
},
{
"api": "Data\/Country\/CH"
},
{
"api": "Data\/Country\/CH\/PLZ"
},
{
"api": "Data\/Country\/LI"
},
{
"api": "Data\/Country\/LI\/PLZ"
},
{
"api": "Data\/GeoId"
},
{
"api": "GeoTree\/CH"
},
{
"api": "GeoTree\/ISO"
}
]
}
},
"application\/xml": {
"schema": {
"type": "object",
"xml": {
"name": "fcal_api"
}
},
"example": "\r\nfcal API 2.0<\/interface>\r\n\r\nhttps:\/\/feiertagskalender.ch<\/href>\r\nFeiertagskalender.ch<\/description>\r\n<\/source>\r\n\r\nhttps:\/\/psc.ch<\/href>\r\npsc Peter Schuetz Informatik-Dienstleistungen, CH Bern<\/description>\r\n<\/copyright>\r\n2025-02-26<\/date>\r\napi_key<\/apiName>\r\nactive<\/apiKeyStatus>\r\n2021-03-31<\/apiDateStart>\r\n2026-03-31<\/apiDateEnd>\r\n\r\nAT,CH,DE,LI<\/dataPublicHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsPublicHolidays>\r\nAT,CH,DE,LI<\/dataSchoolHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsSchoolHolidays>\r\n<\/apiData>\r\n\r\napi_key<\/api>\r\nCheckDate\/CH\/BFS<\/api>\r\nCheckDate\/CH\/PLZ<\/api>\r\nCheckDate\/GeoId<\/api>\r\nData\/Aggreg<\/api>\r\nData\/CH\/BFS<\/api>\r\nData\/CH\/Kanton<\/api>\r\nData\/CH\/PLZ<\/api>\r\nData\/Country<\/api>\r\nData\/Country\/CH<\/api>\r\nData\/Country\/CH\/PLZ<\/api>\r\nData\/Country\/LI<\/api>\r\nData\/Country\/LI\/PLZ<\/api>\r\nData\/GeoId<\/api>\r\nGeoTree\/CH<\/api>\r\nGeoTree\/ISO<\/api>\r\n<\/apiList>\r\n<\/fcal_api>"
},
"application\/csv": {
"example": "\"interface\";\"apiKeyStatus\";\"apiDateStart\";\"apiDateEnd\";\"dataPublicHolidays\";\"yearsPublicHolidays\";\"dataSchoolHolidays\";\"yearsSchoolHolidays\";\"api\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"api_key\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Aggreg\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/Kanton\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/ISO\""
}
}
},
"403": {
"description": "Accesso negato - Chiave API non valida.",
"content": {
"application\/json": {
"examples": {
"invalid_key": {
"summary": "Chiave API non valida.",
"value": {
"apiStatus": {
"description": "invalid key"
}
}
},
"invalid_usage": {
"summary": "L'uso di questa API non è abilitato per questo utente.",
"value": {
"apiStatus": {
"description": "invalid usage"
}
}
},
"invalid_referer": {
"summary": "Accesso non valido. Non sono ammessi link da pagine web (front-end).",
"value": {
"apiStatus": {
"description": "invalid referer"
}
}
},
"inactive": {
"summary": "L'API non è ancora stata attivata per l'uso.",
"value": {
"apiStatus": {
"description": "inactive"
}
}
},
"expired": {
"summary": "Il periodo di utilizzo secondo il contratto è scaduto.",
"value": {
"apiStatus": {
"description": "expired"
}
}
}
}
}
}
},
"500": {
"description": "Interner Serverfehler – ein unerwarteter Fehler ist aufgetreten.",
"content": {
"application\/json": {
"example": {
"error": {
"code": 500,
"message": "Interner Serverfehler. Bitte versuchen Sie es später erneut."
}
}
}
}
}
}
},
"post": {
"tags": [
"Controllo delle funzioni API"
],
"summary": "Questa API controlla lo stato della chiave API. ",
"description": "**api_key** Questa API controlla lo stato della chiave API. Il parametro richiesto è `api_key`. 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. ",
"requestBody": {
"required": true,
"content": {
"application\/json": {
"schema": {
"type": "object",
"properties": {
"api_key": {
"type": "string"
},
"charset": {
"type": "string",
"enum": [
"utf-8",
"iso-8859-1"
],
"default": "utf-8"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv"
],
"default": "json"
}
},
"required": [
"api_key"
]
},
"example": {
"api_key": "YOUR_API_KEY",
"format": "JSON"
}
}
}
},
"responses": {
"200": {
"description": "Risposta di successo con i risultati della query. L'output CSV contiene una struttura tabellare piatta in cui gli elementi JSON\/XML annidati non sono mappati. Si noti che alcuni campi di dati non sono disponibili in formato CSV.",
"content": {
"application\/json": {
"example": {
"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 Arch"
},
"apiName": "api_key",
"date": "2025-02-26",
"apiKeyStatus": "active",
"apiDateStart": "2021-03-31",
"apiDateEnd": "2026-03-31",
"apiData": {
"dataPublicHolidays": "AT,CH,DE,LI",
"yearsPublicHolidays": "2020,2021,2022,2023,2024,2025,2026",
"dataSchoolHolidays": "AT,CH,DE,LI",
"yearsSchoolHolidays": "2020,2021,2022,2023,2024,2025,2026"
},
"apiList": [
{
"api": "api_key"
},
{
"api": "CheckDate\/CH\/BFS"
},
{
"api": "CheckDate\/CH\/PLZ"
},
{
"api": "CheckDate\/GeoId"
},
{
"api": "Data\/Aggreg"
},
{
"api": "Data\/CH\/BFS"
},
{
"api": "Data\/CH\/Kanton"
},
{
"api": "Data\/CH\/PLZ"
},
{
"api": "Data\/Country"
},
{
"api": "Data\/Country\/CH"
},
{
"api": "Data\/Country\/CH\/PLZ"
},
{
"api": "Data\/Country\/LI"
},
{
"api": "Data\/Country\/LI\/PLZ"
},
{
"api": "Data\/GeoId"
},
{
"api": "GeoTree\/CH"
},
{
"api": "GeoTree\/ISO"
}
]
}
},
"application\/xml": {
"schema": {
"type": "object",
"xml": {
"name": "fcal_api"
}
},
"example": "\r\nfcal API 2.0<\/interface>\r\n\r\nhttps:\/\/feiertagskalender.ch<\/href>\r\nFeiertagskalender.ch<\/description>\r\n<\/source>\r\n\r\nhttps:\/\/psc.ch<\/href>\r\npsc Peter Schuetz Informatik-Dienstleistungen, CH Bern<\/description>\r\n<\/copyright>\r\n2025-02-26<\/date>\r\napi_key<\/apiName>\r\nactive<\/apiKeyStatus>\r\n2021-03-31<\/apiDateStart>\r\n2026-03-31<\/apiDateEnd>\r\n\r\nAT,CH,DE,LI<\/dataPublicHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsPublicHolidays>\r\nAT,CH,DE,LI<\/dataSchoolHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsSchoolHolidays>\r\n<\/apiData>\r\n\r\napi_key<\/api>\r\nCheckDate\/CH\/BFS<\/api>\r\nCheckDate\/CH\/PLZ<\/api>\r\nCheckDate\/GeoId<\/api>\r\nData\/Aggreg<\/api>\r\nData\/CH\/BFS<\/api>\r\nData\/CH\/Kanton<\/api>\r\nData\/CH\/PLZ<\/api>\r\nData\/Country<\/api>\r\nData\/Country\/CH<\/api>\r\nData\/Country\/CH\/PLZ<\/api>\r\nData\/Country\/LI<\/api>\r\nData\/Country\/LI\/PLZ<\/api>\r\nData\/GeoId<\/api>\r\nGeoTree\/CH<\/api>\r\nGeoTree\/ISO<\/api>\r\n<\/apiList>\r\n<\/fcal_api>"
},
"application\/csv": {
"example": "\"interface\";\"apiKeyStatus\";\"apiDateStart\";\"apiDateEnd\";\"dataPublicHolidays\";\"yearsPublicHolidays\";\"dataSchoolHolidays\";\"yearsSchoolHolidays\";\"api\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"api_key\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Aggreg\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/Kanton\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/ISO\""
}
}
},
"403": {
"description": "Accesso negato - Chiave API non valida.",
"content": {
"application\/json": {
"examples": {
"invalid_key": {
"summary": "Chiave API non valida.",
"value": {
"apiStatus": {
"description": "invalid key"
}
}
},
"invalid_usage": {
"summary": "L'uso di questa API non è abilitato per questo utente.",
"value": {
"apiStatus": {
"description": "invalid usage"
}
}
},
"invalid_referer": {
"summary": "Accesso non valido. Non sono ammessi link da pagine web (front-end).",
"value": {
"apiStatus": {
"description": "invalid referer"
}
}
},
"inactive": {
"summary": "L'API non è ancora stata attivata per l'uso.",
"value": {
"apiStatus": {
"description": "inactive"
}
}
},
"expired": {
"summary": "Il periodo di utilizzo secondo il contratto è scaduto.",
"value": {
"apiStatus": {
"description": "expired"
}
}
}
}
}
}
},
"500": {
"description": "Interner Serverfehler – ein unerwarteter Fehler ist aufgetreten.",
"content": {
"application\/json": {
"example": {
"error": {
"code": 500,
"message": "Interner Serverfehler. Bitte versuchen Sie es später erneut."
}
}
}
}
}
}
}
}
}
}