ERF Bibleserver für Webmaster

Die Entwickler-Tools von ERF Bibleserver unterstützen dich bei der manuellen und automatischen Verlinkung von Bibelstellen auf deiner Website. Im Folgenden ist die offizielle ERF Bibleserver API ausführlich erläutert.

Hinweis: ERF Bibleserver bietet keine API für die Inhalte von Bibelversen. Aus Lizenzgründen ist dies nicht möglich.

Bibelstellen serverseitig automatisch verlinken

ERF Bibleserver bietet eine serverseitige Schnittstelle, mit der sich Bibelstellen innerhalb eines Textes automatisch erkennen und verlinken lassen. Zur Nutzung der Schnittstelle ist ein API-Key erforderlich. Da die Anzahl der täglichen API-Abrufe je Key begrenzt ist, wird empfohlen die Bibelstellen beim Abspeichern des Textes anstatt bei der Darstellung auf der Website zu parsen.

Die API ist unter https://www.bibleserver.com/api/parser abrufbar.
Es können folgende Parameter per GET oder POST übergeben werden:

  • key - Domain-spezifischer API-Key
  • text - Inhalt, der geparst werden soll
  • lang - Sprache: ar, bg, cs, da, de, en, es, fa, fr, hr, hu, it, nl, no, pl, pt, ro, ru, sk, sv, tr, uk, zh_CN (optional)
  • trl - Abkürzung der Übersetzung, siehe Tabelle oben (optional)
  • cssignore - Bibelstellen, die durch ein HTML-Tag mit dieser CSS-Klasse eingeschlossen sind, werden nicht ersetzt; default: nolink (Bsp. <span class="nolink">Joh 3,16</span>) (optional)

Das folgende PHP-Beispiel zeigt die Nutzung der serverseitigen API:


// POST-Daten definieren
$text = 'Lies Johannes 3,16 in der Bibel.';
$param = array(
    'key' => 'DEIN_API_KEY',
    'text' => $text,
    'lang' => 'de',
    'trl' => 'LUT'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://www.bibleserver.com/api/parser');
curl_setopt($ch, CURLOPT_REFERER, 'http://'.$_SERVER['SERVER_NAME']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $param);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($httpcode === 200) {
    $text = $result;
}

curl_close($ch);
                
php

Ergebnis des PHP-Beispiels:

Lies Johannes 3,16 in der Bibel.

Bibelstellen clientseitig automatisch verlinken

Die JavaScript-Implementierung der API ermöglicht das Erkennen und Verlinken von Bibelstellen im Browser. Für die Nutzung der JavaScript-API ist ein API-Key erforderlich.

Hinweis: Die JavaScript-Implementierung ist eine vereinfachte Version der serverseitigen API. Evtl. werden nicht alle Bibelstellen korrekt erkannt. Außerdem kann es durch die DOM-Manipulationen zu Problemen mit JavaScript-Events kommen.

Das folgende HTML/JavaScript-Beispiel zeigt die Nutzung der clientseitigen API:

<!doctype html>
<html>
<head>
    <title>[...]</title>
 
    <!-- Der folgende Skript-Block muss angepasst und auf deiner Website eingefügt werden. -->
    <script type="text/javascript">
    (function() {
        var ga = document.createElement('script');
        ga.src = 'https://www.bibleserver.com/api/parser.js?key=DEIN_API_KEY&lang=de';
        ga.setAttribute('async', 'true');
        document.documentElement.firstChild.appendChild(ga);
    })();
 
    var bsQuery = '.article'; // CSS-Selektor für Wrapper der Suche (optional)
    var bsTrl   = 'LUT';      // Verlinkte Übersetzung (optional)
    </script>
</head>
<body>
    [...]
    <h1>Johannes 3</h1>
    <div class="article">
        <p>Lies Johannes 3,16 in der Bibel.</p>
    </div>
    [...]
</body>
</html>
html

Ergebnis des JavaScript-Beispiels:

Johannes 3

Lies Johannes 3,16 in der Bibel.

Parameter für den API-Aufruf:

  • key - Domain-spezifischer API-Key
  • lang - Sprache, Bibelstellen werden je nach Sprache erkannt: ar, bg, cs, da, de, en, es, fa, fr, hr, hu, it, nl, no, pl, pt, ro, ru, sk, sv, tr, uk, zh_CN; default: 'de' (optional)

Zusätzliche JavaScript-Optionen:

  • bsQuery - jQuery-Selektor zur Einschränkung der Suche nach Bibelstellen. Standard ist "body" - eine Einschränkung wird empfohlen. (optional)
  • bsTrl - Abkürzung der Übersetzung, siehe Tabelle oben (optional)
  • cssIgnore - Bibelstellen, die durch ein HTML-Tag mit dieser CSS-Klasse eingeschlossen sind, werden nicht ersetzt; default: nolink (Bsp. <span class="nolink">Joh 3,16</span>) (optional)

Wordpress-Plugin

Für Wordpress gibt es das Plugin "Link To Bible", welches beim Abspeichern von Artikeln Bibelstellen automatisch mit ERF Bibleserver verlinkt. Weitere Informationen findest du auf der Plugin-Website.

API-Key erstellen

Um Bibelstellen clientseitig oder serverseitig automatisch verlinken zu können, ist ein API-Schlüssel erforderlich. Dieser ist domain-spezifisch und kann hier kostenlos angefordert werden.

Hinweis: ERF Bibleserver behält sich vor, die täglichen API-Zugriffe je Domain zu beschränken.

Datenschutzerklärung ERF Bibleserver API

Deine Privatsphäre ist uns wichtig!

Deshalb werden bei der Nutzung der ERF Bibleserver API zur automatischen Verlinkung von Bibelstellen keine personenbezogenen Daten gespeichert. Wir bieten jedoch eine Schnittstelle (API) an, welche es dir ermöglicht Bibelstellen in Texten mit ERF Bibleserver zu verlinken. Bei der clientseitigen automatischen Verlinkung, die auf dem Endgerät ausgeführt wird und mit unserem Server kommuniziert, werden keine Inhalte an ERF Bibleserver übertragen.

Bei der serverseitigen automatischen Verlinkung werden Inhalt jedoch an ERF Bibleserver übertragen. Für die Verlinkung von Bibelstellen werden diese auf dem Webserver durch Algorithmen analysiert, bearbeitet und an den Client ausgeliefert. Dabei werden jedoch keine übermittelten Inhalte gespeichert oder an Dritte weitergegeben. Für die Weiterentwicklung und zur Fehleranalyse werden lediglich statistische Werte, wie der Zeitpunkt oder die Dauer der API-Aufrufe, für einen Zeitraum von 120 Tagen gespeichert.

Rechtsgrundlage für die Nutzung bei der serverseitigen Verlinkung ist Art. 6 Abs. 1 S. 1 lit. f DSGVO.