Offene Schnittstellen

Inhalte einfach einbinden.

Heilige, Zitate, Patronate und Tagesheilige 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. Der Detailendpunkt enthält zusätzlich Biografie, Lebensdaten, Patronate und Zitate.

Liste als JSON

https://heiligenzitate.de/api/v1/heilige?suche=Josef&limit=25&offset=0

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/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

Tagesheilige ohne Jahresbindung

GET

Tag und Monat werden getrennt übergeben. Dadurch bleibt die Einbindung jedes Jahr aktuell.

JSON

https://heiligenzitate.de/api/v1/tagesheilige?tag=11&monat=8

Iframe

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

Patronate

Schutzheilige nach Anliegen

GET

Patronate können als Liste oder mit allen zugeordneten Heiligen abgerufen und eingebettet werden.

JSON und Iframe

https://heiligenzitate.de/api/v1/patronate
https://heiligenzitate.de/api/v1/patronate/76

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

Entwicklung und technische Umsetzung: Eble IT.