Free Use Bible API

Fazer pedidos

Para acessar a API, basta fazer uma solicitação HTTP GET para o endpoint correto.

Por exemplo, para acessar o endpoint available_translations.json , você pode usar o seguinte comando JavaScript ou 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);
    });

Abaixo, você encontrará uma lista de exemplos. Para obter documentação mais completa, consulte a Documentação de Referência .

Exemplos

Obtenha a lista de traduções disponíveis

( referência )

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 livros traduzidos

( referência )

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

JavaScript
// Obtenha a lista de livros para a tradução 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);
    });

Obtenha um capítulo a partir de uma tradução.

( referência )

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

JavaScript
// Obtenha Gênesis 1 na tradução BSB.
fetch(`https://bible.helloao.org/api/BSB/GEN/1.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (BSB):', chapter);
    });

Obtenha um capítulo simplificado a partir de uma tradução.

( referência )

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

Use esta opção quando você quiser apenas o texto de um capítulo. Cada versículo contém uma única sequência text em vez de uma lista de conteúdo formatado, então você não precisa construir o texto manualmente.

JavaScript
// Obtenha o texto de Gênesis 1 na tradução 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}`);
            }
        }
    });

Obtenha a lista de comentários disponíveis.

( referência )

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);
    });

Listar livros em um comentário

( referência )

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

// Obtenha a lista de livros para o comentário 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);
    });

Obtenha um capítulo de um comentário.

( referência )

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

// Obtenha Gênesis 1 no comentário 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);
    });

Liste os perfis em um comentário.

( referência )

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

// Obtenha a lista de perfis para o comentário 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);
    });

Obtenha um perfil em um comentário.

( referência )

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

// Obtenha o perfil de Aaron no comentário 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);
    });

Obtenha a lista de conjuntos de dados disponíveis.

( referência )

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);
    });

Obtenha a lista de livros em um conjunto de dados.

( referência )

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

// Obtenha a lista de livros para o conjunto de dados 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);
    });

Obter um capítulo de um conjunto de dados

( referência )

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

// Obtenha o Genesis 1 do conjunto de dados 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);
    });