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 - 2017 psc Peter Schütz Informatik Dienstleistungen, CH-Bern