Bible Desktop
Разработчикам

API Bible Desktop

Единый каталог всех HTTP-операций и редактор для пробного запроса. Выберите метод слева, заполните параметры и посмотрите реальный ответ текущего сервера.

Начало работы

Базовый адрес: https://bible-desktop.com/api. Для JSON передавайте Accept: application/json. Большинство чтений доступны без ключа. Полезные данные обычно лежат в data; азбука использует собственные поля version, letters и conversion.

Доступ и ограничения

Переводчик и OCR допускают бесплатный доступ с X-Bible-Desktop-Client и постоянным UUID в X-Bible-Desktop-Installation. Повышенный лимит даёт X-API-Key. Профиль использует отдельный X-Profile-Secret. При ошибках учитывайте 401, 404, 409, 422, 429 и 503.

Машиночитаемая схема

OpenAPI 3.1 JSON содержит все маршруты, параметры и примеры. Статистика API показывает объём доступного содержимого. Для интеграции календаря и редактора года используйте раздел «Календарь». Число запросов ограничено для календаря, профиля и обучения.

Попробовать запрос

Загрузка операций…

Ответ сервера

Ответ появится здесь.

Как использовать ответы

Начните с GET /translations, сохраните translation.code, затем запросите книги перевода и нужную главу. Для чтений календаря сопоставляйте код OSIS с книгой выбранного перевода. При 422 исправьте параметры из errors; при 429 уменьшите частоту и повторите позже. В ответах календаря учитывайте язык и профиль поста. Для секретов профиля используйте собственное защищённое хранилище.

Тексты, изображения и персональные данные могут иметь разные условия использования. Подробности приведены в условиях API.