Бесплатно · Без API-ключа · Без лимитов

API Библии by Midvash

Стихи, главы и книги из свободных переводов Библии (переводов: 107, языков: 67). JSON по HTTPS, можно вызывать прямо из браузера. Без регистрации и без ключа.

Получите стих одним вызовом

Вызывайте API напрямую. Без настройки и авторизации.

const res = await fetch('https://api.midvash.com/v1/kjv/john/3/16');
const { data, meta } = await res.json();
console.log(data.text);
console.log(meta.copyright); // show it with the text

Почему стоит использовать

Свободные переводы: 107

Синодальный перевод, KJV, BSB, Лютер 1912, Louis Segond и многие другие. Языков: 67. Все в общественном достоянии или под свободной лицензией.

Атрибуция в комплекте

Каждый ответ с текстом Библии содержит строку об авторских правах перевода. Указать источник можно одним полем.

Быстро на edge

Отдаётся с edge-серверов Cloudflare с долгим кэшем и ETag. Повторная проверка возвращает пустой 304.

Без ключа и лимитов

Без регистрации, без API-ключа, без ошибок 429. Открытый CORS: вызывайте с любой веб-страницы.

Переводы и лицензии

Переводов: 107, языков: 67. Все в общественном достоянии или под свободной лицензией. Нажмите на перевод, чтобы увидеть метаданные и полный текст лицензии.

Указывайте источник рядом с текстом

Каждый ответ с текстом Библии содержит сведения об авторских правах перевода: meta.copyright в v1, copyright в /v1/votd и в устаревших маршрутах. Показывайте их рядом с отрывком. Лицензии CC BY и CC BY-SA этого требуют.

Запросили перевод, которого больше нет?

Переводы, все права на которые защищены (NIV, ESV, NLT, NVI, ARA, NVT, NTV и другие), не отдаются. Старые ссылки продолжают работать: вы получите свободный перевод на том же языке, а data.version покажет, какой именно.

Справочник API

Все эндпоинты v1. Нажмите «Запустить», чтобы отправить реальный запрос и увидеть JSON.

Библейский текст

GET /v1/{version}/{book}/{chapter}

Возвращает полную главу Библии

Параметры
version path обязательный Slug перевода (например, kjv, almeida-livre)
book path обязательный Slug книги на любом языке
chapter path обязательный Номер главы
preview query необязательный Обрезает текст примерно до N символов (от 40 до 2000), для всплывающих подсказок
GET /v1/{version}/{book}/{chapter}/{verse}

Возвращает один стих или диапазон (16 или 16-20)

Параметры
version path обязательный Slug перевода (например, kjv, almeida-livre)
book path обязательный Slug книги на любом языке
chapter path обязательный Номер главы
verse path обязательный Один стих (16) или диапазон (16-20)
GET /v1/votd

Стих дня: один и тот же для всех в один UTC-день, со сведениями об авторских правах (кэш 24 ч)

Параметры
language query необязательный Локаль (en, pt-br, es, fr, de, it, zh, ru, ko). По умолчанию: en.
version query необязательный Slug перевода. По умолчанию — канонический перевод выбранной локали.

Пакетные запросы и разбор

GET /v1/passages

До 50 ссылок за один вызов. Ошибочная ссылка не ломает весь запрос и возвращается на своей позиции.

Параметры
refs query обязательный Ссылки через запятую (не более 50)
version query обязательный Slug перевода
GET /v1/parse

Разбирает ссылку в свободной форме (на любом из 9 языков) на книгу, главу и стихи

Параметры
q query обязательный Ссылка в свободной форме, например Иоанна 3:16-18
version query необязательный Необязательно. Проверяется и возвращается в ответе

Переводы и книги

GET /v1/versions

Список всех доступных переводов Библии (107) с текстом лицензии

Параметры
language query необязательный Фильтр по коду языка ISO (полный список — /v1/versions)
GET /v1/versions/{slug}

Возвращает метаданные конкретного перевода

Параметры
slug path обязательный Slug на любом языке
GET /v1/books

Список 66 книг Библии

Параметры
testament query необязательный "old" или "new"
GET /v1/books/{slug}

Возвращает метаданные книги (slug на любом языке)

Параметры
slug path обязательный Slug на любом языке

Руководства «копировать-вставить»

Один и тот же запрос — в инструментах, которыми вы уже пользуетесь.

Получить один стих /v1/kjv/john/3/16

curl https://api.midvash.com/v1/kjv/john/3/16

Список переводов одного языка /v1/versions?language=pt-br

curl 'https://api.midvash.com/v1/versions?language=pt-br'

Стих дня /v1/votd?language=en

curl 'https://api.midvash.com/v1/votd?language=en'

Формат ответа и кэширование

Каждый эндпоинт v1 говорит на одном JSON-конверте и по одним правилам HTTP-кэша.

Конверт успеха

Успешные ответы оборачивают полезную нагрузку в поле data верхнего уровня. Эндпоинты списков и контента добавляют необязательный объект meta: итоги, разрешённую ссылку и, если в ответе есть текст Библии, copyright перевода.

{
  "data": {
    "version": "kjv",
    "book": "john",
    "bookName": "John",
    "chapter": 3,
    "verse": 16,
    "verseEnd": 16,
    "text": "For God so loved the world…",
    "verses": ["For God so loved the world…"]
  },
  "meta": {
    "reference": "John 3:16",
    "total": 1,
    "copyright": "King James Version (KJV)\nPublic Domain.\n…"
  }
}

HTTP и кэш

КэшированиеКонтент неизменяемый — кэшируется на год (max-age=31536000, immutable). Новый контент приходит по новому URL, а не в изменённом теле.
РевалидацияКаждый ответ несёт сильный ETag. Отправьте If-None-Match и получите 304 Not Modified без тела.
CORSОткрыт для любого источника (Access-Control-Allow-Origin: *). Вызывайте прямо из браузера — без прокси.
МетодыGET, HEAD и OPTIONS. HEAD возвращает только заголовки; OPTIONS обрабатывает CORS preflight.
Одно исключение — /v1/votd

Стих дня возвращает плоский объект (reference, text, version, book_slug, chapter, verse_start, verse_end, url, copyright) вместо конверта data/meta и кэшируется на 24 часа.

Ошибки

Каждая ошибка использует один формат и стабильный машиночитаемый код.

{
  "error": {
    "code": "BOOK_NOT_FOUND",
    "message": "Book \"jhon\" not found. Did you mean \"john\"?",
    "details": { "didYouMean": "john" }
  }
}
КодHTTPКогда возникает
INVALID_PARAMS 400 Значение пути или запроса некорректно — например, номер главы вне диапазона.
NOT_FOUND 404 Маршрут не существует под /v1.
VERSION_NOT_FOUND 404 Ни один перевод не соответствует указанному slug — ошибка подсказывает ближайший (didYouMean).
BOOK_NOT_FOUND 404 Ни одна книга не соответствует slug, ни на одном языке — ошибка подсказывает ближайшую (didYouMean).
CHAPTER_NOT_FOUND 404 Этой главы нет в этом переводе.
VERSE_NOT_FOUND 404 Стих или диапазон вне главы.
INTERNAL_ERROR 500 Что-то сломалось на нашей стороне — повтор безопасен.

Ответы 4xx кэшируются от 60 секунд до 24 часов в зависимости от детерминированности ошибки; 5xx не кэшируются никогда, чтобы повторы всегда доходили до источника.

66 книг

Slug работают на любом языке, с дефисом или без (2-samuel или 2samuel). Нажмите книгу, чтобы получить метаданные.

Ветхий Завет 39
Быт
Бытие
бытие 50 гл.
Исх
Исход
исход 40 гл.
Лев
Левит
левит 27 гл.
Чис
Числа
числа 36 гл.
Втор
Второзаконие
второзаконие 34 гл.
Нав
Иисус Навин
иисус-навин 24 гл.
Суд
Судьи
судьи 21 гл.
Руф
Руфь
руфь 4 гл.
1Цар
1 Царств
1-царств 31 гл.
2Цар
2 Царств
2-царств 24 гл.
3Цар
3 Царств
3-царств 22 гл.
4Цар
4 Царств
4-царств 25 гл.
1Пар
1 Паралипоменон
1-паралипоменон 29 гл.
2Пар
2 Паралипоменон
2-паралипоменон 36 гл.
Езд
Ездра
ездра 10 гл.
Неем
Неемия
неемия 13 гл.
Есф
Есфирь
есфирь 10 гл.
Иов
Иов
иов 42 гл.
Пс
Псалтирь
псалтирь 150 гл.
Прит
Притчи
притчи 31 гл.
Еккл
Екклесиаст
екклесиаст 12 гл.
Песн
Песнь Песней
песнь-песней 8 гл.
Ис
Исаия
исаия 66 гл.
Иер
Иеремия
иеремия 52 гл.
Плач
Плач Иеремии
плач-иеремии 5 гл.
Иез
Иезекииль
иезекииль 48 гл.
Дан
Даниил
даниил 12 гл.
Ос
Осия
осия 14 гл.
Иоил
Иоиль
иоиль 3 гл.
Ам
Амос
амос 9 гл.
Авд
Авдий
авдий 1 гл.
Ион
Иона
иона 4 гл.
Мих
Михей
михей 7 гл.
Наум
Наум
наум 3 гл.
Авв
Аввакум
аввакум 3 гл.
Соф
Софония
софония 3 гл.
Агг
Аггей
аггей 2 гл.
Зах
Захария
захария 14 гл.
Мал
Малахия
малахия 4 гл.

Частые вопросы

Это правда бесплатно? Нужен ли API-ключ?

Да. Без регистрации, без ключа и без лимита запросов. Просим только учитывать ETag (If-None-Match возвращает 304) и объединять ссылки через /v1/passages вместо отдельного запроса на каждый стих.

Какие переводы доступны?

Переводов: 107, языков: 67. Все в общественном достоянии или под свободной лицензией, например CC BY или CC BY-SA. Актуальный список: /v1/versions.

Почему нет NIV или ESV?

Их издатели сохраняют за собой все права, поэтому мы их не распространяем. На запрос такого перевода приходит свободный перевод на том же языке, а data.version показывает, какой.

Что нужно показывать в приложении?

Сведения об авторских правах перевода из meta.copyright (или copyright в /v1/votd и устаревших маршрутах) рядом с текстом. Некоторые лицензии добавляют условия, например распространение на тех же условиях (CC BY-SA) или запрет изменять текст (CC BY-ND). Прочитайте полный текст лицензии выбранного перевода.

Есть ли спецификация OpenAPI?

Да: /openapi.json (OpenAPI 3.1) и интерактивная справка на /docs. Для ИИ-агентов есть MCP Библии на mcp.midvash.com.