Schnittstelle (API) für Websites, Apps und Präsentationen

Die Liedvorschläge direkt in Ihrer Anwendung.

Über die Schnittstelle holen sich Gemeinde-Websites, Beamer-Programme, Chor-Apps oder Infobildschirme die aktuellen Liedvorschläge automatisch – immer auf dem neuesten Stand, ohne Abtippen.

Zugang anfragen Was abrufbar ist

Wozu?

Einmal gepflegt – überall aktuell

Die Liedvorschläge werden hier jeden Monat eingepflegt. Die Schnittstelle liefert sie in einem maschinenlesbaren Format (JSON) aus. So zeigen andere Anwendungen genau das an, was hier steht – und ändern sich automatisch mit.

Liedvorschlägewerden hier gepflegt
Schnittstelleliefert sie mit Ihrem Schlüssel aus
Ihre Anwendungfragt regelmäßig ab
Gemeindesieht die Lieder – immer aktuell

Für wen?

Wer die Schnittstelle nutzt

Gemeinde-Websites

„Lieder am nächsten Sonntag“ direkt auf der Startseite – ohne dass jemand sie abtippen muss.

Beamer & Präsentation

Liednummer, Titel und Strophen automatisch auf den Folien für den Gottesdienst.

Chor- & Musik-Apps

Die kommenden Gottesdienste mit allen Liedern in der eigenen Planungs-App.

Infobildschirme

Im Foyer oder Schaukasten: nächster Gottesdienst, Thema, Bibelwort, Lieder.

Bezirks- & Jugendseiten

Themen und Bibelworte der kommenden Wochen für Vorbereitung und Ankündigungen.

Noten- & Liederbuch-Software

Verzeichnisse von Liederbüchern abgleichen und Lieder schnell finden.

Beispiel: Gemeinde-Website zeigt die Lieder für den nächsten Sonntag

Beispiel 1

Auf der Website der Gemeinde

Die Website fragt z. B. einmal am Tag „nächster Gottesdienst“ ab
Thema, Bibelwort und alle Lieder mit Nummer, Titel und Strophen
Gestaltung ganz nach Ihrer Website – die Schnittstelle liefert nur die Daten

Beispiel: Beamer-Folie mit Eingangslied, Nummer und Strophen

Beispiel 2

Auf dem Beamer im Gottesdienst

Präsentationssoftware lädt die Lieder des Tages automatisch
Eingangs-, Buß-, Abendmahls- und Reservelied sind eindeutig benannt
Strophenangaben als Liste – z. B. „Strophen 1 und 4“

Beispiel: Chor-App mit den nächsten Gottesdiensten und Liedern

Beispiel 3

In einer Chor- oder Planungs-App

Die nächsten Gottesdienste mit allen Liedern auf einen Blick
Abfrage nach Datum, Zeitraum, Art des Gottesdienstes oder Lied
Zu jedem Gottesdienst ein Link zur Detailseite und zum Bibeltext

Was abrufbar ist

Diese Daten liefert die Schnittstelle

Abrufbar ist nur, was diese Website selbst veröffentlicht. Welche Bereiche Sie erhalten, wird für jeden Zugang einzeln festgelegt.

Gottesdienste & Liedvorschläge

Standard

Für jeden Gottesdienst mit Liedvorschlag.

Datum, Art und Bezeichnung (z. B. Sonntag, Wochengottesdienst, Feiertag)
Thema, Textwort und Bibellesung
Lieder je Liedart: Nummer, Titel, Strophen
Hinweise zum Gottesdienst

Abfragen nach Zeit

Standard

So finden Sie die passenden Gottesdienste.

nächster Gottesdienst bzw. die nächsten (bis 20)
alle Gottesdienste an einem Datum
Zeitraum oder Monat, mit Filtern nach Art und Lied
einzelner Gottesdienst über seine Kennung

Lied-Verlauf

Standard

Wann wurde ein Lied vorgeschlagen – und als welche Liedart?

alle Vorschläge eines Liedes mit Datum und Strophen

Liederbücher

auf Freigabe

Inhaltsverzeichnisse freigegebener Bücher und Mappen.

Nummer, Titel, Rubrik, Tonart, Taktart
einzelnes Lied eines Buches

Suche & Konkordanz

auf Freigabe

Lieder nach Wörtern, Themen und Bibelstellen finden.

Volltextsuche in Titeln und Stichworten
Konkordanz mit Fundstellen

Liedtexte & Bibeltexte

nur mit Berechtigung

Texte unterliegen dem Urheberrecht.

nur, wenn die Rechte dafür vorliegen
Umfang je Zugang einzeln geregelt

Nicht über die Schnittstelle

persönliche Daten von Nutzern
Liednachweise der Gemeinden
Gottesdienst-, Dienst- und Gemeindepläne
Abwesenheiten, Gruppen, Nachrichten

Öffentliche Termine einer Gemeinde gibt es separat als Kalender-Abo – das legt die Gemeinde selbst fest.

Beispiel einer Abfrage und der Antwort im JSON-Format

Für Entwickler

So funktioniert es technisch

REST-Schnittstelle über HTTPS, Antworten als JSON (UTF-8)
Persönlicher Schlüssel im Header X-LV-API-Key
Abfragelimit je Stunde, Abrufe werden protokolliert
Aus dem Browser nutzbar (CORS) – auch für reine HTML/JavaScript-Websites
Vollständige Dokumentation mit Beispielen auf Ihrer persönlichen Zugangsseite

Zugang

In vier Schritten zum eigenen Schlüssel

AnfragenFormular unten ausfüllen: wer Sie sind und wofür Sie die Daten nutzen möchten.
FreigabeWir prüfen die Anfrage und legen fest, welche Bereiche Ihr Zugang erhält.
Persönlicher LinkSie erhalten eine E-Mail mit dem Link zu Ihrer Zugangsseite.
Schlüssel erzeugenDort erzeugen Sie Ihren Schlüssel (mit Einmal-Passwort) und finden die Anleitung mit Beispielen.

Persönliche Zugangsseite: Schlüssel erzeugen und Übersicht der Schnittstelle

Zugang anfragen

Sie möchten die Schnittstelle nutzen?

Schreiben Sie uns kurz, wofür Sie die Liedvorschläge verwenden möchten. Wir melden uns per E-Mail.

Ihre Angaben verwenden wir nur für die Bearbeitung der Anfrage.
Jeder Zugang hat einen eigenen Schlüssel und lässt sich jederzeit sperren.

Häufige Fragen

Brauche ich Programmierkenntnisse?

Für die Anbindung ja – oder jemanden, der Ihre Website bzw. App betreut. Auf der persönlichen Zugangsseite stehen fertige Beispiele, u. a. zum Kopieren für eine Website.

Wie aktuell sind die Daten?

Die Schnittstelle liefert immer den aktuellen Stand dieser Website. Neue Monate und Änderungen sind sofort abrufbar.

Bekomme ich auch die Liedtexte?

Liedtexte und Bibeltexte unterliegen dem Urheberrecht. Sie werden nur ausgeliefert, wenn die Rechte dafür vorliegen – sprechen Sie uns in der Anfrage darauf an.

Gibt es Grenzen?

Ja, eine Höchstzahl an Abfragen je Stunde. Für Websites genügt es, die Daten z. B. einmal täglich abzurufen und zwischenzuspeichern.

Was passiert, wenn mein Schlüssel verloren geht?

Auf Ihrer Zugangsseite erzeugen Sie jederzeit einen neuen. Der alte wird dabei sofort ungültig.