Start

Funktionskontrolle

geografische Daten

Kalenderdaten

Schweiz

Spezial

English version

Willkommen auf der API-Ebene von fcal.ch

Mit dem fcal.ch REST-API können Sie unsere Daten automatisiert auslesen und in eigene Anwendungen integrieren.

 

Voraussetzungen

Die Benutzung des fcal.ch APIs ist kostenpflichtig und bedingt einen Nutzungsvertrag.

API Abonnemente sind verfügbar auf folgenden Levels:

  • alle erfassten Länder
  • 1, oder mehrere Länder
  • 1, oder mehrere Schweizer Kantone
  • 1, oder mehrere Gemeinden / City

zur Offertanfrage

 

Anfragen und Antworten

Das API akzeptiert nur GET und POST Anfragen.

Die Antwort erfolgt als JSON codiertes Array, oder dem in der Anfrage definierten Format.

 

Sicherheit

Zugriffe

Aus Sicherheitsgründen sind API-Zugriffe nur direkt, oder aus einem Back-End möglich. Zugriffe über Front-Ends sind nicht zulässig.

SSL/HTTPS

Das fcal.ch API soll nur via https:// aufgerufen werden. Aus Sicherheitsgründen sollten Sie auch Ihre Anwendung, Ihr Interface mit SSL gegen unerwünschtes Mitlesen schützen.

API-Key

Die Identifikation / Authentisierung zum API erfolgt mittels API-Key. Ihren API-Key finden Sie auf Ihrer Nutzungsvereinbarung, oder Rechnung.

 

Daten

Verfügbar sind alle auf Feiertagskalender.ch erfassten Daten gemäss IST-Situation:

Feiertage und Schulferien werden im API als Kalenderdaten (events) bezeichnet.

Sprachen: Deutsch, Französisch, Italienisch, Englisch

 

Formate

Unterstützt werden die Formate: JSON, XML und CSV

 

Vorgehen

1) Prüfen Sie zuerst mit der API-Funktionskontrolle, ob Ihr API-Key korrekt funktioniert.

2) Fragen Sie mit dem ISO-API den geografischen Baum der Region ab, welche Sie interessiert.

3) In der Antwort finden Sie die verfügbaren Regionen, Orte mit ihren Geo-ID oder City-ID.

4) Fragen Sie die Kalenderdaten jetzt mit dem passenden API ab: geoId oder cityId

 

Für die Schweiz stehen separate APIs zur Verfügung für die Abfrage nach Kanton, Postleitzahl oder BFS-Gemeindenummer.

 

 

©2003 - 2018 psc Peter Schütz Informatik Dienstleistungen, CH-Bern