Free Use Bible API

Отправка запросов

Для доступа к API достаточно отправить HTTP GET-запрос к нужной конечной точке.

Например, для доступа к конечной точке available_translations.json можно использовать следующую команду JavaScript или 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);
    });

Ниже приведен список примеров. Более подробную информацию см. в разделе «Справочная документация» .

Примеры

Получить список доступных переводов

( ссылка )

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

Список книг в переводе

( ссылка )

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

JavaScript
// Получите список книг для перевода 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);
    });

Получить главу из перевода

( ссылка )

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

JavaScript
// Получите первую главу Книги Бытия из перевода BSB.
fetch(`https://bible.helloao.org/api/BSB/GEN/1.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (BSB):', chapter);
    });

Получите упрощенную главу из перевода.

( ссылка )

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

Используйте это, если вам нужен только текст главы. Каждый стих содержит одну строку с text значением вместо списка отформатированного содержимого, поэтому вам не нужно самостоятельно формировать текст.

JavaScript
// Получите текст первой главы Книги Бытия из перевода 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}`);
            }
        }
    });

Получить список доступных комментариев

( ссылка )

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

Список книг в комментарии

( ссылка )

JavaScript
fetch-commentary-books.js
const commentary = '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);
    });

Получить главу из комментария

( ссылка )

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

// Возьмите первую главу Книги Бытия из комментария Адама Кларка.
fetch(`https://bible.helloao.org/api/c/${commentary}/${book}/${chapter}.json`)
    .then(request => request.json())
    .then(chapter => {
        console.log('Genesis 1 (adam-clarke):', chapter);
    });

Список биографий в комментарии

( ссылка )

JavaScript
fetch-commentary-profiles.js
const commentary = '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);
    });

Получите профиль в комментарии

( ссылка )

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

// Ознакомьтесь с биографией Аарона Тиндаля в комментариях Тиндаля.
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);
    });

Получить список доступных наборов данных

( ссылка )

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

Получить список книг в наборе данных

( ссылка )

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

// Получите список книг для набора данных 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);
    });

Извлечь главу из набора данных

( ссылка )

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

// Получите первую главу Книги Бытия из набора данных 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);
    });