Offene Schnittstellen

Inhalte einfach einbinden.

Heilige, Zitate, Fürsprachen/Patronate, Feste/Hochfeste und Kalenderdaten stehen als JSON und als fertige, responsive Einbettung zur Verfügung.

JSON-API

Strukturierte Daten für Apps, Websites und eigene Darstellungen. Alle Antworten sind UTF-8-kodiert und ohne externen Schlüssel abrufbar.

Iframe

Fertige, barrierearme Karten im Design von Heiligenzitate. Die Einbettungen passen sich automatisch an ihre verfügbare Breite an.

Quellenangabe

Die Nutzung ist kostenlos. Bitte „Heiligenzitate“ als Quelle nennen und nach Möglichkeit auf die konkrete Fundstelle verlinken.

Heilige

Einzelne Heilige und Listen

GET

Eine Liste lässt sich durchsuchen und über limit sowie offset seitenweise abrufen. Zusätzlich stehen Filter für liturgisch, gedenktag, land und patronat bereit. Der Detailendpunkt enthält Biografie, Lebensdaten, Fürsprachen, Patronate und Zitate.

Liste als JSON

https://heiligenzitate.de/api/v1/heilige?suche=Josef&limit=25&offset=0
https://heiligenzitate.de/api/v1/heilige?liturgisch=true&gedenktag=19.03
https://heiligenzitate.de/api/v1/heilige?land=Deutschland&patronat=1

Ein Heiliger als JSON

fetch('https://heiligenzitate.de/api/v1/heilige/767')
  .then(response => response.json())
  .then(data => console.log(data.item));

Iframe-Code

<iframe
  src="https://heiligenzitate.de/einbetten/heilige/767"
  title="Abel von Reims bei Heiligenzitate"
  loading="lazy"
  width="100%"
  height="420"
  style="border:0;border-radius:16px"
></iframe>

Live-Vorschau

Zitate

Zitate einzeln oder gesammelt

GET

Zitatlisten können nach Text oder Namen durchsucht werden. Für wechselnde Inhalte steht zusätzlich ein Zufallszitat bereit.

JSON-Endpunkte

https://heiligenzitate.de/api/v1/zitate?suche=Hoffnung&limit=20
https://heiligenzitate.de/api/v1/zitate/1916
https://heiligenzitate.de/api/v1/zitate/code/KD7cd
https://heiligenzitate.de/api/v1/zitate?heiliger=111
https://heiligenzitate.de/api/v1/zitate/zufall

Zitat als Iframe

<iframe src="https://heiligenzitate.de/einbetten/zitat/1916" title="Zitat bei Heiligenzitate" loading="lazy" width="100%" height="260" style="border:0;border-radius:16px"></iframe>

Mehrere Zitate als Iframe

<iframe src="https://heiligenzitate.de/einbetten/zitate?anzahl=3" title="Zitate bei Heiligenzitate" loading="lazy" width="100%" height="620" style="border:0;border-radius:16px"></iframe>

Kalender

Heilige und Feste nach Kalendertag

GET

Der Kalender akzeptiert entweder datum=JJJJ-MM-TT oder Tag, Monat und optional Jahr. Die Antwort gruppiert liturgische Heilige, weitere Heilige, Hochfeste und weitere Feste. Der bisherige Endpunkt /api/v1/tagesheilige bleibt kompatibel.

JSON

https://heiligenzitate.de/api/v1/kalender?datum=2026-09-27
https://heiligenzitate.de/api/v1/kalender/jahr/2026
https://heiligenzitate.de/api/v1/tagesheilige?tag=27&monat=9&jahr=2026

Iframe

<iframe src="https://heiligenzitate.de/einbetten/tagesheilige?tag=27&monat=9" title="Kalender bei Heiligenzitate" loading="lazy" width="100%" height="520" style="border:0;border-radius:16px"></iframe>

Feste

Feste und Hochfeste

GET

Feste können durchsucht und mit typ=hochfest oder typ=fest gefiltert werden. Bewegliche Hochfeste enthalten eine Berechnungsregel und ein für das gewählte jahr berechnetes Datum; Detailantworten enthalten außerdem Titel, Beschreibung und Hochfest-Kennzeichnung.

JSON-Endpunkte

https://heiligenzitate.de/api/v1/feste?typ=hochfest&limit=50
https://heiligenzitate.de/api/v1/feste?suche=Himmelfahrt
https://heiligenzitate.de/api/v1/feste?gedenktag=15.08&jahr=2026

Fürsprachen

Schutzheilige nach Anliegen

GET

Fürsprachen und Patronate können als Liste oder mit allen zugeordneten Heiligen abgerufen werden. Filter: typ=patronat|fuersprache und regional=true|false. Zusätzlich existieren die Alias-Endpunkte /api/v1/fuersprachen.

JSON und Iframe

https://heiligenzitate.de/api/v1/fuersprachen
https://heiligenzitate.de/api/v1/fuersprachen?typ=patronat&regional=false
https://heiligenzitate.de/api/v1/patronate
https://heiligenzitate.de/api/v1/fuersprachen/99

<iframe src="https://heiligenzitate.de/einbetten/patronat/99" title="Patronat Apotheker" loading="lazy" width="100%" height="420" style="border:0;border-radius:16px"></iframe>

Entwicklung und technische Umsetzung: Eble IT.