API und Framework

Kalenderinformationen zuverlässig beziehen

Bei Calidario wird die API bereits seit Jahren für den Kalender-Konfigurator und für die individuellen Kalender verwendet. Sie steht aber auch Dritten zur Verfügung und eignet sich hervorragend für Online- und Offline-Anwendungen.

Für technische Informationen und technischen Support wenden Sie sich bitte an Bit&Black.

Jetzt Preise und Token anfordern

Adresse und Endpunkte

Die REST-API kann unter api.calidar.io aufgerufen werden. Für die Abfrage ist ein Token notwendig.

Diese Endpunkte stehen zur Verfügung:

• calendarsystems Nach Ländern sortiert die landestypische Kalenderart, der Tag, mit welchem ein Jahr beginnt und das Jahr 0, von dem an alle anderen Jahre gezählt werden.
• cities Nach Ländern sortiert sämtliche Städte samt Postleitzahl, Bundesland/Region, und den geografischen Koordinaten.
• countries Alle Länder der Erde mit ihrem Ländercode nach ISO 3166 Alpha-2 und ISO 3166 Alpha-3, der Währung, der Population, dem Kontinent, der Hauptstadt, den Sprachcodes der dort gesprochenen Sprachen, den geografischen Koordinaten und der Fläche in Quadratkilometern.
• countrynames Alle Länder der Erde übersetzt in andere Sprachen.
• days Die Tagesnamen in fast allen Sprachen der Erde.
• holidays Die Feiertage aller europäischen Länder. Enthalten sind die Bezeichnung, das Datum und die jeweiligen Bundesländer/Regionen, in denen der Feiertag begangen wird.
• languages Alle Sprachen der Erde. Die Liste enthält den Ländercode nach ISO 639-1, den Sprachcode nach LCID, die Beschreibung und die landestypische Kalenderart.
• months Die Monatsnamen in fast allen Sprachen der Erde.
• moonphases Die Mondphasen in verschiedenen Sprachen.
• namedays Die Namenstage aller europäischer Länder.
• starsigns Die Namen der Tierkreiszeichen in verschiedenen Sprachen.
• states Die Bundesländer/Regionen verschiedener Länder.
• vacations Die Schulferien verschiedener Länder samt Bezeichnung, Beginn und Ende sowie der Angabe des jeweiligen Bundeslandes bzw. der jeweiligen Region.

Funktionen

Diese Funktionalitäten bietet das Calidario-Framework:

• Daten können in andere Kalendersysteme konvertiert werden. Das bedeutet: Daten aus dem gregorianischen, dem julianischen und dem islamischen Kalender (Hijri) können jeweils umgerechnet werden.
• Tagesnamen können für eine bestimmte Sprache abgefragt werden.
• Die Nummer eines Tages in einer Woche kann errechnet werden.
• Das Osterdatum für die West- und die Ostkirche kann für ein bestimmtes Jahr errechnet werden.
• Der Frühlingsanfang und der Herbstanfang kann für ein bestimmtes Jahr errechnet werden.
• Es kann geprüft werden, ob ein bestimmter Tag einen Feiertag beinhaltet. Die Unterscheidung zwischen landesweiten Feiertagen und teilweisen Feiertagen ist möglich.
• Monatsnamen können für eine bestimmte Sprache abfragt werden.
• Der erste und der letzte Tag sowie die Gesamtzahl der Tage in einem bestimmten Monat können errechnet werden.
• Namenstage können nach Tag oder nach Name abgefragt werden.
• Tierkreiszeichen können abgefragt werden.
• Mondphasen können abgefragt und in verschiedenen Sprachen ausgegeben werden.
• Bundesländer/Regionen können für ein bestimmtes Land abgefragt werden.
• Der Sonnenaufgang und der Sonnenuntergang kann für eine bestimmte geografische Position errechnet werden.
• Die Schulferien eines bestimmten Landes können abgefragt werden.
• Die Wochennummer zu einem bestimmten Datum kann errechnet werden.

Installation und technische Anforderungen

Das Calidario-Framework 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. Die Library benötigt PHP >=7.4 sowie die Calendar-Extension (ext-calendar), die JSON-Extension (ext-json) und die Multibyte-String-Extension (ext-mbstring).

Jetzt Preise und Token anfordern