Integrieren Sie Calidario in Ihre eigenen Dienstleistungen: mit unserer Daten-API, der Kalender-API und dem SDK für PHP können Sie von unseren Stärken in Ihren Anwendungen profitieren.
Mit der Calidario Daten-API stehen Ihnen alle Kalenderinformationen bereit, die Sie für Ihre Produkte brauchen – gebündelt an einem einzigen Ort, fortlaufend aktualisiert und sorgfältig geprüft.
Die Daten-API bündelt dreizehn Datenkategorien: von Feiertagen und Schulferien über Länder, Städte und Sprachen bis hin zu Mondphasen, Namenstagen und Tierkreiszeichen. Statt vieler Einzelquellen genügt ein einziger Ansprechpartner.
Viele Bezeichnungen liefert Calidario bereits übersetzt in die Sprachen der Welt. Feiertage und Ferientermine werden zusätzlich mit Quellenangabe und Aktualisierungsdatum ausgeliefert – so wissen Sie stets, worauf Sie sich stützen.
Die API ist seit Jahren im Kalender-Konfigurator von Calidario im Einsatz und steht auch Dritten zur Verfügung. Sie eignet sich für Online-Anwendungen ebenso wie für Offline- und Print-Produkte.
Der Zugriff erfolgt über eine klassische REST-API. Mit einem Token haben Sie Zugriff auf alle Daten und können sie ganz nach Ihrem Bedarf filtern – zum Beispiel nach Land, Sprache oder Jahr.
Die vollständige technische Dokumentation mit allen Endpunkten finden Sie unter api.calidar.io.
Alle relevanten Kalenderinformationen an einem Ort – für jeden Einsatz und jedes Produkt.
Die Daten werden fortlaufend aktualisiert und validiert und mit Quellenangabe geliefert.
Bezeichnungen in den Sprachen der Welt – für internationale Anwendungen und Oberflächen.
Das können Sie mit der Daten-API abrufen:
Die Feiertage aller Länder mit übersetzten Namen, den betroffenen Bundesländern bzw. Regionen und gültigen Verschiebungsregeln. Für jedes Jahr werden die konkreten Kalenderdaten geliefert – im jeweiligen Kalendersystem: westlich (gregorianisch), orthodox und julianisch mit eigenem Ostersonntag, islamisch, jüdisch sowie chinesisch.
Schulferien samt Bezeichnung, Beginn und Ende sowie dem zuständigen Bundesland bzw. der Region – ideal für Reise-, Bildungs- und Planungsprodukte.
Wissenswertes zu allen Ländern der Erde: Hauptstadt, Währung, Bevölkerung, gesprochene Sprachen, Kontinent und geografische Lage.
Alle Ländernamen übersetzt in die Sprachen der Welt – für mehrsprachige Anwendungen und Oberflächen.
Städte mit Postleitzahl, Region und geografischen Koordinaten – gefiltert nach Land.
Alle Sprachen mit ihrem Sprachcode und der landestypischen Kalenderart.
Die Namen der Wochentage in fast allen Sprachen der Erde.
Die Namen der Monate in fast allen Sprachen der Erde.
Die Bezeichnungen der Mondphasen in verschiedenen Sprachen.
Die Namenstage aller europäischen Länder – nach Datum oder Namen abrufbar.
Die Namen der Tierkreiszeichen in verschiedenen Sprachen.
Die Bundesländer und Regionen verschiedener Länder – für regionale Zuordnungen.
Nach Ländern sortiert: die landestypische Kalenderart, der Jahresbeginn und die Jahreszählung.
Alles Weitere – Endpunkte, Parameter und technische Details – finden Sie in der Dokumentation der Daten-API.
Die Kalender-API von Calidario erlaubt die Generierung von Kalendern aller Art.
Unsere Kalenderschnittstelle ermöglicht die vollautomatisierte Generierung von Kalenderlayouts. Sämtliche dafür relevanten Datenformate werden unterstützt, darunter:
Die offenen Daten erlauben eine Nachbearbeitung sämtlicher Informationen und Gestaltungselemente.
Individualkalender mit eigenem Corporate Design, eigenem Logo, eigenen Bildern etc. sind möglich.
Der Zugriff erfolgt via REST-API.
Die Kalender-API kann unter calendar-api.calidar.io aufgerufen werden. Für die Abfrage ist ein Token notwendig.
Das Calidario-SDK verarbeitet Kalenderdaten in PHP-Projekten. Es verbindet die Calidario-Daten-API mit einem umfangreichen Rechenwerk, das viele Kalenderwerte selbst erzeugt – ganz ohne zusätzlichen API-Aufruf.
Diese Angaben holt das SDK über die Calidario-Daten-API. Dafür benötigen Sie ein Token.
Diese Werte entstehen vollständig auf Ihrem eigenen Server. Dafür braucht es weder Token noch Netzwerkzugriff.
Das Calidario-SDK steht als PHP-Library zur Verfügung und kann über Composer eingebunden werden. Es handelt sich um eine private Library, für die ein Token nötig ist.
Dazu wird das Private Packagist-Repository von Calidario in der Projektkonfiguration hinterlegt. Anschließend genügt der Befehl composer require calidario/framework.
Die Library benötigt PHP >= 8.2 sowie die Calendar-Extension (ext-calendar), die JSON-Extension (ext-json) und die Multibyte-String-Extension (ext-mbstring).
Für die Kommunikation setzt das SDK auf PSR-18 und PSR-17. Sie können Ihren eigenen HTTP-Client einbinden, und Antworten lassen sich für eine frei wählbare Zeit in Sekunden zwischenspeichern. Das Token wird als Bearer-Token im Authorization-Header übermittelt und steht damit nicht in der URL.
Mondkalender vertragen keine halben Sachen. Deshalb rechnet das SDK die astronomischen Werte nach den anerkannten Verfahren der astronomischen Handbücher – und macht die Quellen nachvollziehbar.
Der genaue Zeitpunkt, zu dem der Mond ein Tierkreiszeichen betritt oder verlässt, wird bis auf ein bis zwei Minuten genau bestimmt – auch an den Tagen, an denen der Mond zweimal das Zeichen wechselt.
Sie entscheiden, ob Sie das tropische Tierkreiszeichen, die dreizehn echten Sternbilder mit dem Schlangenträger oder ein Vergleichsmodell mit zwölf Sternbildregionen verwenden. Alle Grenzen werden mit der Präzession der Erdachse korrigiert und bleiben auch weit vom Bezugsjahr 2000 gültig.
Viele Mondkalender tragen in der Tageszelle das Sternbild ein, in das der Mond an diesem Tag hineinwechselt. Diese Tagesregel liefert das SDK ebenso wie die genaue Uhrzeit des Wechsels auf Wunsch direkt mit.
Die Berechnung folgt Jean Meeus und seinem Standardwerk »Astronomical Algorithms«. Die Monddeklination weicht an zwanzig Prüftagen zwischen 2011 und 2029 um höchstens 0,007° von der Referenzephemeris JPL Horizons ab, das Musterbeispiel aus Meeus wird exakt getroffen.
Haben Sie Interesse an den Calidario-APIs oder am Calidario-SDK? Schreiben Sie uns!