Stift und Papier als Basis guter Gestaltung

REST APIs und SDK

Integrieren Sie Calidario in Ihrer Dienstleistung

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.

Die Calidario Daten-API

Mit der Calidario Daten-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.

Die Daten werden fortlaufend aktualisiert und überprüft. Calidario ist sich dabei der hohen Anforderung und seiner Verantwortung in der Kalenderbranche bewusst. Aus diesem Grunde werde auch sämtliche Feiertage und Ferientermine Termine mit Quellenangabe und Aktualisierungsdatum versehen.

In der Kombination von verschiedensten Informationen, deren Aktualisierung und Validierung bietet Calidario daher den größten und zuverlässigsten Datensatz für Kalender an.

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

Adresse und Endpunkte

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

Jetzt Preise und Token anfordern

Kalendersysteme

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.

Beispiel-Response von api.calidario/v1/calendarsystems mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de",
            "type_of_calendar": "CAL_GREGORIAN",
            "first_day_of_year": "0101",
            "year_from_christ": 0
        }
    ]
}

Städte

Nach Ländern sortiert sämtliche Städte samt Postleitzahl, Bundesland/Region, und den geografischen Koordinaten.

Beispiel-Response von api.calidario/v1/cities mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 93077,
            "country_code": "DE",
            "postal_code": "70372",
            "place_name": "Stuttgart Bad Cannstatt",
            "admin_name1": "Baden-Württemberg",
            "admin_code1": "BW",
            "admin_name2": "Reg.-Bez. Stuttgart",
            "admin_code2": "081",
            "admin_name3": "Stuttgart",
            "admin_code3": "08111",
            "latitude": "48.8056",
            "longitude": "9.2141",
            "accuracy": 0
        }
    ]
}

Länder

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.

Beispiel-Response von api.calidario/v1/countries mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 57,
            "country_code": "de",
            "country_name": "Germany",
            "currency_code": "EUR",
            "population": "81802257",
            "fips_code": "GM",
            "iso_numeric": "276",
            "north": "54.9113475100612",
            "south": "47.2701236047002",
            "east": "15.0418156516163",
            "west": "5.86625035072566",
            "capital": "Berlin",
            "continent_name": "Europe",
            "continent": "EU",
            "area_in_sq_km": "357021.0",
            "languages": "de",
            "iso_alpha3": "DEU",
            "geoname_id": 2921044
        }
    ]
}

Ländernamen

Alle Länder der Erde übersetzt in andere Sprachen.

Beispiel-Response von api.calidario/v1/countrynames mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 28,
            "en_gb": "Germany",
            "de_de": "Deutschland",
            "de_at": "Deutschland",
            "de_ch": "Deutschland",
            "en_us": "Germany"
        }
    ]
}

Tage

Die Tagesnamen in fast allen Sprachen der Erde.

Beispiel-Response von api.calidario/v1/days mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 57,
            "language_code": "de-de",
            "day1": "Sonntag",
            "day2": "Montag",
            "day3": "Dienstag",
            "day4": "Mittwoch",
            "day5": "Donnerstag",
            "day6": "Freitag",
            "day7": "Samstag"
        }
    ]
}

Feiertage

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.

Beispiel-Response von api.calidario/v1/holidays mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 15,
            "date_code": "",
            "description": "Pfingstsonntag",
            "names": [],
            "country_code": "de",
            "state": [
                "Brandenburg"
            ],
            "day_formula": [
                "+49 days"
            ],
            "day_origin": "easter",
            "year": null,
            "calendar_type": "gregorian",
            "source_of_information": "https://de.wikipedia.org/wiki/Pfingsten",
            "date_information_updated": "2026-03-20T10:45:37+01:00",
            "translation_en": "Pentecost Sunday",
            "identifiers": [
                "PENTECOST_DATE"
            ]
        }
    ]
}

Sprachen

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.

Beispiel-Response von api.calidario/v1/languages mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 39,
            "language_code": "de-de",
            "language_description": "Deutsch (Deutschland)",
            "country_code": "DE",
            "type_of_calendar": "CAL_GREGORIAN"
        }
    ]
}

Monate

Die Monatsnamen in fast allen Sprachen der Erde.

Beispiel-Response von api.calidario/v1/months mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 32,
            "language_code": "de-de",
            "month1": "Januar",
            "month2": "Februar",
            "month3": "März",
            "month4": "April",
            "month5": "Mai",
            "month6": "Juni",
            "month7": "Juli",
            "month8": "August",
            "month9": "September",
            "month10": "Oktober",
            "month11": "November",
            "month12": "Dezember"
        }
    ]
}

Mondphasen

Die Mondphasen in verschiedenen Sprachen.

Beispiel-Response von api.calidario/v1/moonphases mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de-de",
            "new_moon": "Neumond",
            "waxing_crescent": "Erstes Viertel",
            "first_quarter": "Zunehmender Halbmond",
            "waxing_gibbous": "Zweites Viertel",
            "full_moon": "Vollmond",
            "waning_gibbous": "Drittes Viertel",
            "third_quarter": "Abnehmender Halbmond",
            "waning_crescent": "Letztes Viertel"
        }
    ]
}

Namenstage

Die Namenstage aller europäischer Länder.

Beispiel-Response von api.calidario/v1/namedays mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 3,
            "country_code": "de",
            "name": "Abraham",
            "date": [
                "0910",
                "2910"
            ],
            "sex": "male"
        }
    ]
}

Tierkreiszeichen

Die Namen der Tierkreiszeichen in verschiedenen Sprachen.

Beispiel-Response von api.calidario/v1/starsigns mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1,
            "language_code": "de-de",
            "starsign1": "Steinbock",
            "starsign2": "Wassermann",
            "starsign3": "Fische",
            "starsign4": "Widder",
            "starsign5": "Stier",
            "starsign6": "Zwilling",
            "starsign7": "Krebs",
            "starsign8": "Löwe",
            "starsign9": "Jungfrau",
            "starsign10": "Waage",
            "starsign11": "Skorpion",
            "starsign12": "Schütze"
        }
    ]
}

Bundesländer/Regionen

Die Bundesländer/Regionen verschiedener Länder.

Beispiel-Response von api.calidario/v1/states mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 143,
            "country_code": "de",
            "state_name": "Baden-Württemberg"
        }
    ]
}

Schulferien

Die Schulferien verschiedener Länder samt Bezeichnung, Beginn und Ende sowie der Angabe des jeweiligen Bundeslandes bzw. der jeweiligen Region.

Beispiel-Response von api.calidario/v1/vacations mit einem einzelnen Eintrag:
{
    "status": 200,
    "messages": [],
    "payload": [
        {
            "id": 1016,
            "vacation_name": "Weihnachtsferien",
            "first_day_date_code": "2027-12-23",
            "last_day_date_code": "2028-01-08",
            "country_code": "de",
            "state_name": "Baden-Württemberg",
            "source_of_information": "https://km.baden-wuerttemberg.de/de/service/ferien",
            "date_information_updated": "2026-02-23T08:00:00+01:00"
        }
    ]
}

Die Calidario Kalender-API

Die Kalender-API von Calidario erlaubt die Generierung von Kalendern aller Art.

Automatisiert vollständige Kalender generieren

Unsere Kalenderschnittstelle ermöglicht die vollautomatisierte Generierung von Kalender(layouts). Sämtliche dafür relevanten Datenformate werden unterstützt, darunter:

  • Web- und Druck-PDF,
  • IDML für Adobe InDesign, QuarkXPress und Affinity,
  • HTML und CSS,
  • JPEG, PNG etc.

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.

Adresse und Endpunkte

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

Jetzt Preise und Token anfordern

Das Calidario-SDK für PHP

Das Calidario-SDK 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-SDK:

  • 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-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. 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 den Calidario-APIs oder am Calidario-SDK? Schreiben Sie uns!