Stift und Papier als Basis guter Gestaltung

API und Framework

Integrieren Sie Calidario in Ihrer Dienstleistung

Die Calidario-API

Mit der Calidario-API haben Sie Zugriff auf alle Informationen, die Sie für Ihre Kalender benötigen. Die Daten werden fortlaufend aktualisiert und garantieren Ihnen fehlerfreie Kalendarien.

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.

Das Calidario-Framework

Das Calidario-Framework stellt eine sinnvolle Ergänzung für die Handhabung der Kalenderinformationen aus der Calidario-API dar. Mithilfe der Library könnte diese Informationen einfacher formatiert und verarbeitet werden.

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

Fragen Sie an

Haben Sie Interesse an der Calidario-API oder am Calidario-Framework? Schreiben Sie uns!