Developer Tools: API

Interfaz de Programación de Aplicaciones (API)

La Interfaz de programación de aplicaciones (API) de BibleSearch le permite a cualquier desarrollador incluir contenido y texto de las Escrituras en su sitio Web o aplicación, para uso no comercial. Si usted no es un desarrollador y desea incluir texto bíblico o el buscador BibleSearch en su sitio Web, vea algunas de nuestras utilidades aquí. Para ustedes desarrolladores, El API de BibleSearch está basada en REST. Pueden leer la documentación completa aquí.

Para entender como usar el API de BibleSearch, por favor, leer las siguientes preguntas frecuentes. Si usted tiene alguna duda, entre a nuestro sitio Foro de API para formular la pregunta. También puede enviarnos un correo electrónico a digitalministry@americanbible.org usando API en la línea de referencia.

¿Cómo obtengo acceso?

Para tener acceso a API, debe registrarse como usuario de BibleSearch y haber activado su token único API, el que obtiene al registrarse aquí. Una vez tenga su token, usted podrá hacer llamadas a API y extraer contenido. Por favor recuerde que cada llamada debe incluir este token de API. Su token de API es único sólo para usted. Es un token privado, así que ¡no lo comparta con nadie!

¿Cómo puedo utilizar yo los textos?

Usted no puede usar para fines comerciales el contenido que baja del API, ni en ninguna aplicación que sea ilegal, ofensiva, obscena, violenta, inmoral o despectiva hacia otros o hacia el texto bíblico. Básicamente, juegue limpio. No altere o cambie el significado del texto bíblico, o su interpretación.

Si desea usar este contenido para propósitos comerciales, deberá obtener la autorización específica contactándonos por correo electrónico a digitalministry@americanbible.org usando API en la línea de referencia. Además, les pedimos mostrar solamente 500 versículos consecutivos al mismo tiempo y, junto a las versiones que está mostrando, incluir la información sobre derechos de autor de las mismas. Usted también puede revisar los Términos y Condiciones completos de API aquí.

¿Qué tipo de aplicaciones puedo construir?

Siempre que use el contenido del texto bíblico para fines no comerciales y en forma positiva que respete la integridad del texto bíblico tal y como se describe arriba, usted podrá crear las aplicaciones que desee. Nosotros siempre estamos atentos a lo que los desarrolladores puedan crear, así que por favor, comparta sus creaciones con nosotros y con la comunidad en Foro API de BibleSearch.

¿Qué versiones están disponibles?

Actualmente sólo podemos ofrecer las versiones Contemporary English Version (CEV), Good News Translation (GNT), King James Version (KJV), y Reina-Valera 1960 (RVR). Deseamos agregar a la brevedad tantas versiones como sea posible, pero primero necesitamos que todas las casas publicadoras estén unidas. Si hay algún material al que usted realmente desea tener acceso, déjenos saber enviando un mensaje o a nuestros foros y haremos todo lo posible que esté nuestras posibilidades para servirles!

¿Por qué no hay mas versiones de la Biblia?

Las versiones de la Biblia son propiedad intelectual de varias casas publicadoras y dueños de derechos. Para dar acceso a una versión bíblica vía API, necesitamos obtener permiso de la casa publicadora que es dueña de los derechos. Si hay algo que usted desea, la forma más rápida de obtener ese permiso es comunicándolo y solicitando acceso a las versiones en nuestro sitio Foro API BibleSearch. Si usted nos escribe lo que desea, podemos acercarnos a los publicadores y tratar que nos complazcan.

Para ayudar a ganar la confianza de los publicadores y propietarios de la propiedad intelectual, hemos preparado el Sistema de Administración de Buen Uso en el API. Esto nos ayuda a proveer un mayor nivel de datos sobre como el contenido de las Escrituras está siendo consumido por los usuarios de API y, finalmente, los usuarios finales de su aplicación. Estamos tratando realmente de enfatizar en la transparencia sobre cómo se utiliza el contenido de las Escrituras por medio de nuestro API, ya que ello mostrará a los publicadores y propietarios de IP que estamos protegiendo su contenido y asegurándonos que mantiene la integridad que merecen las Escrituras.

¿Qué es Sistema de Administración de Buen Uso?

El Sistema de Administración de Buen Uso nos ayuda a perfilar cómo está siendo usado el contenido bíblico por API. Para usarlo, usted incluye un snippet pequeño adicional de código JavaScript cada vez que muestre un resultado de una consulta API en su sitio de Internet. El API siempre regresará el JavaScript correcto a usar por la consulta realizada, de manera que puede agregarlo en su sitio de Internet.

¿Por qué se requiere utilizar el sistema de administración de buen uso?

El Sistema de Administración de Buen Uso nos ayudará a proveer información a los publicadores de Escrituras que les muestre cómo está siendo utilizado su contenido. Nos ayudará a agregar más versiones de Escrituras al API al demostrar el alcance adicional que el acceso API le da a una versión. Y nos ayudará a asignar nuestros recursos para el desarrollo y físicos para garantizar que API se expanda para incluir características y datos que son importantes para los usuarios API.

¿Qué implicaciones tiene el sistema de administración de buen uso para mi aplicación?

El Sistema de Administración de Buen Uso (FUMS, por sus siglas en inglés) tendrá un impacto mínimo en su aplicación. Hemos optimizado el código y entrega del JavaScript para garantizar que sus visitantes no sea afectado por su uso. No se usa información persolmente identificable por FUMS. Además, al continuar fortaleciendo las capacidades de FUMS, usted podrá tener acceso a estadísticas avanzadas que muestran cómo están siendo usados por sus usuarios los datos API que usted está mostrando en su sitio.

¿Puedo hacer un caché de datos?

Usted puede hacer un caché de datos, pero nosotros solicitamos que se limita a menos de 500 versículos consecutivos. También recomendamos que usted borre su caché cada 14 días o menos, porque estamos constantemente actualizando la estructura de nuestros datos y mejorándola para hacerla más accesible a usted. Con esto en mente, no es buena idea mantener un caché por mucho tiempo porque deseamos que usted obtenga el contenido bíblico más actualizado disponible.

¿Cuántas solicitudes puedo hacer en un día? ¿Hay una tarifa límite?

Si, hay una tarifa límite estándar. Usted puede realizar solamente 5,000 consultas en un día. Si usted está preparando una aplicación masiva que requiera más consultas que éstas por día, sírvase contactarnos por correo electrónico o en forum para que podamos hacer algo que se acomode a sus necesidades. Finalmente, deseamos darle acceso al contenido de Escrituras que necesita, protegiendo a nuestros servidores al mismo tiempo.

¿Puedo solicitar permiso para excederme del límite de la tarifa?

¡Estamos abiertos a ello definitivamente! Escríbanos a digitalministry@americanbible.org escribiendo API en el asunto y cuéntenos en lo que está trabajando y qué tipo de acceso necesita. Estamos muy felices de trabajar con usted y tratamos de complacer sus necesidades.

¿Cómo uso el API?

Para comenzar con API, le sugerimos que lea documentación completa para ver las capacidades y limitaciones del API actual. Si usted se pierde o enreda, revise nuestro Foro API de BibleSearch para pedirle ayuda a la comunidad. También leemos el foro a diario y responderemos a las preguntas y solución de problemas. Si usted desea ayuda inmediata, envíe una solicitud de tiquete desde el foro y le responderemos a la mayor brevedad posible.

¿Debo de mostrar los derechos de autor en cada versión que despliego?

Si. Creemos firmemente que es importante dar crédito a los publicadores que son propietarios de los derechos de una versión en particular de contenido bíblico. Así, sírvase incluir la información de derechos de autor al lado de toda la Escritura que despliegue.

¿Cómo obtengo mi versión en el API?

Si usted es un publicador o propietario de propiedad intelectual y desea quqe su versión de la Biblia esté disponible en BibleSearch y mediante el API, nos encantaría saber de usted. Escríbanos a digitalministry@americanbible.org

¿Y si mi pregunta no ha sido contestada aquí?

Tenemos un foro forum para que usted explore las preguntas y contribuciones de la comunidad, así como los artículos de nuestro equipo de desarrollo. Si usted no encuentra lo que está buscando y desea ayuda inmediata, escríbanos a digitalministry@americanbible.org escribiendo API en el título del asunto.