Free Use Bible API

Hacer peticiones

Para acceder a la API, solo necesita realizar una solicitud HTTP GET al punto final correcto.

Por ejemplo, para acceder al punto final available_translations.json , puede utilizar el siguiente comando JavaScript o cURL:

JavaScript
fetch(`https://bible.helloao.org/api/available_translations.json`)
    .then(request => request.json())
    .then(availableTranslations => {
        console.log('The API has the following translations:', availableTranslations);
    });

A continuación, encontrará una lista de ejemplos. Para obtener una documentación más completa, consulte la documentación de referencia .

Ejemplos

Obtén la lista de traducciones disponibles.

( referencia )

GET https://bible.helloao.org/api/available_translations.json

JavaScript
fetch(`https://bible.helloao.org/api/available_translations.json`)
    .then(request => request.json())
    .then(availableTranslations => {
        console.log('The API has the following translations:', availableTranslations);
    });

Lista de libros traducidos

( referencia )

GET https://bible.helloao.org/api/{translation}/books.json

JavaScript
// Obtén la lista de libros para la traducción de BSB
fetch(`https://bible.helloao.org/api/BSB/books.json`)
    .then(request => request.json())
    .then(books => {
        console.log('The BSB has the following books:', books);
    });

Obtén un capítulo de una traducción

( referencia )

GET https://bible.helloao.org/api/{translation}/{book}/{chapter}.json

JavaScript
// Obtén Génesis 1 de la traducción BSB
fetch(`https://bible.helloao.org/api/BSB/GEN/1.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (BSB):', chapter);
    });

Obtén un capítulo simplificado de una traducción.

( referencia )

GET https://bible.helloao.org/api/{translation}/{book}/{chapter}.simple.json

Utilice esta opción cuando solo necesite el texto de un capítulo. Cada versículo contiene una única cadena vacía text en lugar de una lista de contenido formateado, por lo que no tendrá que generar el texto usted mismo.

JavaScript
// Obtén el texto de Génesis 1 de la traducción BSB.
fetch(`https://bible.helloao.org/api/BSB/GEN/1.simple.json`)
    .then(request => request.json())
    .then(chapter => {
        for (let content of chapter.chapter.content) {
            if (content.type === 'verse') {
                console.log(`${content.number}. ${content.text}`);
            }
        }
    });

Obtenga la lista de comentarios disponibles.

( referencia )

JavaScript
fetch-commentaries.js
fetch(`https://bible.helloao.org/api/available_commentaries.json`)
    .then(request => request.json())
    .then(availableCommentaries => {
        console.log('The API has the following commentaries:', availableCommentaries);
    });

Lista de libros en un comentario

( referencia )

JavaScript
fetch-commentary-books.js
const commentary = 'adam-clarke';

// Obtén la lista de libros para el comentario de Adam Clarke.
fetch(`https://bible.helloao.org/api/c/${commentary}/books.json`)
    .then(request => request.json())
    .then(books => {
        console.log('The adam-clarke commentary has the following books:', books);
    });

Obtén un capítulo de un comentario

( referencia )

JavaScript
fetch-commentary-chapter.js
const commentary = 'adam-clarke';
const book = 'GEN';
const chapter = 1;

// Obtén Génesis 1 del comentario de Adam Clarke.
fetch(`https://bible.helloao.org/api/c/${commentary}/${book}/${chapter}.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (adam-clarke):', chapter);
    });

Enumerar perfiles en un comentario

( referencia )

JavaScript
fetch-commentary-profiles.js
const commentary = 'tyndale';

// Obtén la lista de perfiles para los comentarios de Tyndale.
fetch(`https://bible.helloao.org/api/c/${commentary}/profiles.json`)
    .then(request => request.json())
    .then(profiles => {
        console.log('The tyndale commentary has the following profiles:', profiles);
    });

Obtén un perfil en un comentario

( referencia )

JavaScript
fetch-commentary-profile.js
const commentary = 'tyndale';
const profile = 'aaron';

// Obtén el perfil de Aaron del comentario de Tyndale.
fetch(`https://bible.helloao.org/api/c/${commentary}/profiles/${profile}.json`)
    .then(request => request.json())
    .then(profile => {
        console.log('The Aaron tyndale commentary profile:', profile);
    });

Obtén la lista de conjuntos de datos disponibles.

( referencia )

JavaScript
fetch-datasets.js
fetch(`https://bible.helloao.org/api/available_datasets.json`)
    .then(request => request.json())
    .then(availableDatasets => {
        console.log('The API has the following datasets:', availableDatasets);
    });

Obtener la lista de libros en un conjunto de datos.

( referencia )

JavaScript
fetch-dataset-books.js
const dataset = 'open-cross-ref';

// Obtén la lista de libros para el conjunto de datos open-cross-ref.
fetch(`https://bible.helloao.org/api/d/${dataset}/books.json`)
    .then(request => request.json())
    .then(books => {
        console.log('The open-cross-ref dataset has the following books:', books);
    });

Obtener un capítulo de un conjunto de datos

( referencia )

JavaScript
fetch-dataset-chapter.js
const dataset = 'open-cross-ref';
const book = 'GEN';
const chapter = 1;

// Obtén Génesis 1 del conjunto de datos open-cross-ref.
fetch(`https://bible.helloao.org/api/d/${dataset}/${book}/${chapter}.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (open-cross-ref):', chapter);
    });