Entwickler

DIENSTENDPUNKT

BibleGet verwendet einen i/o-Typ-Dienst "Endpunkt" auf Ihrem eigenen Server, der Anwendungen ermöglichen Anwendungen den Server mit einer Abfrage Abfragen, wodurch eine biblische Angebotsanfrage ausgesetzt ist. Die Anforderung von der Endpunkt-Anwendung gesendet werden strukturierte Daten zurück, in nützlichen Format für die gleiche Anwendung (z. B. JSON-Format ist eine Datenstruktur von Javascript, aber das wird häufig verwendet, für den Austausch strukturierter Daten zwischen Anwendungen, Webdienste oder Sprachen; ein Beispiel der Anwendung möglicherweise ein Plugin für WordPress oder eine Erweiterung für Microsoft Word die einen einzelnen Benutzer zum Ausführen von automatisierten Zitate der Schrift ermöglichen). In der Praxis, die den Dienstendpunkt ein PHP-Skript, das dauert eine Abfrage, die enthält Standardnotation für biblische Zitate und übersetzt sie in MySQL-Abfragen ist, die Ergebnisse im gewünschten Format Formatierung können die vom Typ JSON, XML oder HTML sein.

ENDPUNKT-URL

Die Haupt-Url für Anfragen ist Http://query.bibleget.io/(which corresponds to http://www.bibleget.io/query/). Es ist jetzt eine erweiterte PHP-Engine entwickelt, die derzeit an die URL-http://query.bibleget.io/index2.php befindet. Dieser neue Motor können Sie Anfragen stellen in jeder Sprache (die Bücher der Bibel können in einem der vielen verschiedenen Sprachen gezeigt werden, gibt es derzeit Albanisch, Englisch, Französisch, Deutsch, Ungarisch, Italienisch, Polnisch, Rumänisch, Russisch, Spanisch, TAGALOG), sowie das erlauben Sie die biblische Version anzugeben, den Sie möchten.

PARAMETER

Die Parameter, die Sie an den Endpunkt senden können sind:

• "Abfrage" *: dieser Parameter ist erforderlich. Ihr Wert muss ein gültiger Antrag entsprechen, die die standard-Notation für die biblischen Zitate verwendet. Siehe die Abschnitt Standard Notation für biblische Zitate in den Informationen für den Benutzer.
• "Version": (optional) Wenn Sie diesen Parameter nicht angeben, der Standardwert ist "cei2008".  Mit diesem Parameter können Sie die biblische Version angeben gewünschte. Sie können auch angeben, mehrere Versionen aufgelistet mit Komma, um mehrere Versionen von Texten zu vergleichen. Derzeit gibt es nur die Versionen "cei2008" und "Luzzi".
• "Rückkehr": (optional) Dies ist das Format, in denen Sie strukturierte Daten zurückgeben möchten. Der Parameter akzeptiert einen von drei Werten: "Json", "Xml" oder "html".

WIE SIE DEN ENDPUNKT ABFRAGEN

Die Abfrage kann auf verschiedene Weise an den Endpunkt erfolgen:

• von PHP mit CURL
• von Javascript mit einer AJAX-Aufruf (der auch ein PHP-Skript, CURL verwendet, verwenden könnte)
• Attribut "Src" als ein "Iframe"-Element in einer HTML-Seite (und mit der "zurückgeben = html")
• Sprache oder Anwendung, die einen Aufruf einer URL machen kann kann den Dienst zu verhören und die empfangenen Daten verarbeiten. In Java gibt es z. B. Bibliotheken, die Sie URLs aufrufen können.

Beispielabfrage: http://query.bibleget.io/?query=Mt1, 1-10; 2,2-4 & Rückkehr = html. Versuchen Sie, durch Klicken auf diesen Link, um ein Beispiel der Daten zurückgegeben werden, hier im HTML-Format mit minimalen Struktur und Formatierung zu sehen. Jetzt versuchen Sie dieses, die die gleichen Daten im JSON-Format ohne Formatierung oder Seite Struktur zurückgibt: http://query.bibleget.io/?query=Mt1, 1-10; 2,2-4 & Rückkehr = Json.

Beispielabfrage an den neuen Motor zu entwickeln: http://query.bibleget.io/index2.php? Abfrage = Matthäus1:1-10; 2:2-4 & Version = cei2008, Luzzi & Rückkehr = html.

Sie können versuchen, sich um bestimmte Abfragen formulieren und finden den AntworttyArea Sandboxp.