Desarrolladores

PUNTO FINAL DEL SERVICIO

BibleGet utiliza un servicio de tipo de entrada-salida "Punto final" en su propio servidor que está expuesto a las aplicaciones, para permitir que aplicaciones consultar el servidor con una consulta que hace una solicitud de la cita bíblica. La petición enviada por la aplicación del punto final devolverá datos estructurados en formato útil para la misma aplicación (como el formato JSON que es una estructura de datos de Javascript, pero que es comúnmente utilizado para intercambiar datos estructurados entre aplicaciones o servicios web o idiomas; un ejemplo de aplicación podría ser un plugin para WordPress, o una extensión para Microsoft Word que permiten a un usuario realizar cotizaciones automatizadas de la escritura). En la práctica que el punto final del servicio es un script PHP que tiene una consulta que contiene notación estándar para las citas bíblicas y lo traduce en consultas MySQL, formatear los resultados en el formato requerido, que puede ser de tipo JSON, XML o HTML.

URL DE PUNTO FINAL

La url principal para pedidos es http://query.bibleget.io/(which corresponds to http://www.bibleget.io/query/). Ahora está desarrollando un motor PHP más avanzado, que se encuentra actualmente en la URL http://query.bibleget.io/index2.php. Este nuevo motor le permite hacer solicitudes en cualquier idioma (los libros de la Biblia se pueden demostrar en uno de los muchos idiomas diferentes, actualmente hay albanés, Inglés, Francés, alemán, Húngaro, Italiano, Polaco, rumano, Ruso, español, Tagalo), así como lo que le permite indicar la versión bíblica que desea.

PARÁMETROS

Los parámetros que usted puede enviar hasta el punto final son:

• "consulta" *: este parámetro es necesario. Su valor debe corresponder a una solicitud válida que utiliza la notación estándar para las citas bíblicas. Ver la notación estándar de la sección de citas bíblicas en la información al usuario.
• "versión": (opcional) si no se especifica este parámetro, el valor predeterminado es "cei2008".  Con este parámetro puede especificar la versión bíblica que usted desea. También puede especificar varias versiones en la lista con comas, para comparar varias versiones de textos. Actualmente hay sólo versiones "cei2008" y "luzzi".
• "volver": (opcional) este es el formato en el cual desea devolver datos estructurados. El parámetro toma uno de tres valores: "json", "xml", o "html".

CÓMO CONSULTAR EL CRITERIO DE VALORACIÓN

La consulta puede hacerse de diversas maneras hasta el punto final:

• desde PHP con CURL
• desde Javascript con una llamada de AJAX (que también se puede usar un script PHP que utiliza CURL)
• atributo "src" como un elemento "iframe" en una página HTML (y usando el "retorno = html")
• cualquier lenguaje o aplicación que puede hacer una llamada a una URL puede interrogar el servicio y procesar los datos recibidos. En Java, por ejemplo, hay librerías que te permiten realizar llamadas a direcciones URL.

Consulta de ejemplo: http://query.bibleget.io/?query=Mt1, 1-10; 2, 2-4 y retorno = html. Trate de hacer clic en este enlace para ver un ejemplo de datos devueltos, aquí en formato HTML con la mínima estructura y formato. Ahora pruebe este uno que devuelve los mismos datos en formato JSON, sin estructura de formato o la página: http://query.bibleget.io/?query=Mt1, 1-10; 2, 2-4 y retorno = json.

Consulta de muestra para el nuevo desarrollo de motor: http://query.bibleget.io/index2.php? consulta = Matthäus1:1-10; 2:2-4 & version = cei2008, luzzi y retorno = html.

Usted puede intentar usted mismo para formular algunas consultas y ver el tipo de respuestArea Sandboxa.