Свободные переводы: 107
Синодальный перевод, KJV, BSB, Лютер 1912, Louis Segond и многие другие. Языков: 67. Все в общественном достоянии или под свободной лицензией.
Стихи, главы и книги из свободных переводов Библии (переводов: 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
Синодальный перевод, KJV, BSB, Лютер 1912, Louis Segond и многие другие. Языков: 67. Все в общественном достоянии или под свободной лицензией.
Каждый ответ с текстом Библии содержит строку об авторских правах перевода. Указать источник можно одним полем.
Отдаётся с 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 покажет, какой именно.
Все эндпоинты v1. Нажмите «Запустить», чтобы отправить реальный запрос и увидеть JSON.
/v1/{version}/{book}/{chapter}
Возвращает полную главу Библии
version |
path | обязательный | Slug перевода (например, kjv, almeida-livre) |
book |
path | обязательный | Slug книги на любом языке |
chapter |
path | обязательный | Номер главы |
preview |
query | необязательный | Обрезает текст примерно до N символов (от 40 до 2000), для всплывающих подсказок |
/v1/{version}/{book}/{chapter}/{verse}
Возвращает один стих или диапазон (16 или 16-20)
version |
path | обязательный | Slug перевода (например, kjv, almeida-livre) |
book |
path | обязательный | Slug книги на любом языке |
chapter |
path | обязательный | Номер главы |
verse |
path | обязательный | Один стих (16) или диапазон (16-20) |
/v1/votd
Стих дня: один и тот же для всех в один UTC-день, со сведениями об авторских правах (кэш 24 ч)
language |
query | необязательный | Локаль (en, pt-br, es, fr, de, it, zh, ru, ko). По умолчанию: en. |
version |
query | необязательный | Slug перевода. По умолчанию — канонический перевод выбранной локали. |
/v1/passages
До 50 ссылок за один вызов. Ошибочная ссылка не ломает весь запрос и возвращается на своей позиции.
refs |
query | обязательный | Ссылки через запятую (не более 50) |
version |
query | обязательный | Slug перевода |
/v1/parse
Разбирает ссылку в свободной форме (на любом из 9 языков) на книгу, главу и стихи
q |
query | обязательный | Ссылка в свободной форме, например Иоанна 3:16-18 |
version |
query | необязательный | Необязательно. Проверяется и возвращается в ответе |
/v1/versions
Список всех доступных переводов Библии (107) с текстом лицензии
language |
query | необязательный | Фильтр по коду языка ISO (полный список — /v1/versions) |
/v1/versions/{slug}
Возвращает метаданные конкретного перевода
slug |
path | обязательный | Slug на любом языке |
/v1/books
Список 66 книг Библии
testament |
query | необязательный | "old" или "new" |
/v1/books/{slug}
Возвращает метаданные книги (slug на любом языке)
slug |
path | обязательный | Slug на любом языке |
Один и тот же запрос — в инструментах, которыми вы уже пользуетесь.
/v1/kjv/john/3/16curl https://api.midvash.com/v1/kjv/john/3/16
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 next to the text
import requests
body = requests.get('https://api.midvash.com/v1/kjv/john/3/16').json()
print(body['data']['text'])
print(body['meta']['copyright']) # show it next to the text
/v1/versions?language=pt-brcurl 'https://api.midvash.com/v1/versions?language=pt-br'
const res = await fetch('https://api.midvash.com/v1/versions?language=pt-br');
const { data, meta } = await res.json();
console.log(meta.total, data);
import requests
r = requests.get('https://api.midvash.com/v1/versions', params={'language': 'pt-br'})
print(r.json()['meta']['total'])
/v1/votd?language=encurl 'https://api.midvash.com/v1/votd?language=en'
const res = await fetch('https://api.midvash.com/v1/votd?language=en');
const votd = await res.json(); // flat shape, no envelope
console.log(votd.reference, votd.text);
console.log(votd.copyright);
import requests
v = requests.get('https://api.midvash.com/v1/votd', params={'language': 'en'}).json()
print(v['reference'], v['text'])
print(v['copyright'])
Каждый эндпоинт 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…"
}
}
| Кэширование | Контент неизменяемый — кэшируется на год (max-age=31536000, immutable). Новый контент приходит по новому URL, а не в изменённом теле. |
| Ревалидация | Каждый ответ несёт сильный ETag. Отправьте If-None-Match и получите 304 Not Modified без тела. |
| CORS | Открыт для любого источника (Access-Control-Allow-Origin: *). Вызывайте прямо из браузера — без прокси. |
| Методы | GET, HEAD и OPTIONS. HEAD возвращает только заголовки; OPTIONS обрабатывает CORS preflight. |
Стих дня возвращает плоский объект (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 не кэшируются никогда, чтобы повторы всегда доходили до источника.
Slug работают на любом языке, с дефисом или без (2-samuel или 2samuel). Нажмите книгу, чтобы получить метаданные.
Те же библейские данные для других сценариев.
Подключите Claude, Cursor и другие ИИ-ассистенты с поддержкой MCP к Библии.
Подробнее →Превращает библейские ссылки на вашем сайте во всплывающие подсказки с текстом стиха на основе этого API.
Подробнее →Ежедневные размышления с глубиной изучения Библии в вебе, на iOS и Android.
Подробнее →Да. Без регистрации, без ключа и без лимита запросов. Просим только учитывать ETag (If-None-Match возвращает 304) и объединять ссылки через /v1/passages вместо отдельного запроса на каждый стих.
Переводов: 107, языков: 67. Все в общественном достоянии или под свободной лицензией, например CC BY или CC BY-SA. Актуальный список: /v1/versions.
Их издатели сохраняют за собой все права, поэтому мы их не распространяем. На запрос такого перевода приходит свободный перевод на том же языке, а data.version показывает, какой.
Сведения об авторских правах перевода из meta.copyright (или copyright в /v1/votd и устаревших маршрутах) рядом с текстом. Некоторые лицензии добавляют условия, например распространение на тех же условиях (CC BY-SA) или запрет изменять текст (CC BY-ND). Прочитайте полный текст лицензии выбранного перевода.
Да: /openapi.json (OpenAPI 3.1) и интерактивная справка на /docs. Для ИИ-агентов есть MCP Библии на mcp.midvash.com.