BookFusion Plugins Research

Реверс-инжиниринг semi-public REST API сервиса BookFusion по исходникам двух официальных плагинов. Результат — документация API, тесты и Calibre-плагин для обратной синхронизации дат чтения.

Исходный url - https://git.viorsan.com/vrr/BookfusionPluginsResearch Зеркало https://github.com/intari/BookfusionResearchPlugins

Структура репозитория

Путь	Описание
calibre-plugin/	Исходники официального Calibre-плагина BookFusion (только чтение)
obsidian-plugin/	Исходники официального Obsidian-плагина BookFusion (только чтение)
docs/api.md	Документация API, восстановленная из исходников
docs/tasks/api-research.md	Тикет с полным результатом исследования
docs/notes.md	Заметки по архитектуре Back Sync и Private API
tests/	Тесты Calibre API и Obsidian API (pytest + bash/curl)
private_api/	Документация и тесты Private API BookFusion
BookfusionBackSync/	Исходники Calibre-плагина Back Sync
BookfusionBackSync.zip	Готовый архив плагина для установки в Calibre

---

BookFusion API

Два semi-public REST API без официальной документации:

API	Base URL	Аутентификация
Calibre API v1	https://www.bookfusion.com/calibre-api/v1	HTTP Basic: base64(api_key:)
Obsidian API	https://www.bookfusion.com	Заголовок X-Token: {token}

Полная документация со всеми эндпоинтами, структурами запросов и ответов — в docs/api.md.

---

Тесты

Тесты охватывают оба API. Obsidian happy-path тесты требуют OBSIDIAN_TOKEN (получается однократно через браузер — см. docs/api.md, раздел 2.2).

pip install pytest requests

# pytest
export API_USER=your_bookfusion_api_key
pytest tests/ -v

# bash/curl (WSL / Linux)
export API_USER=your_bookfusion_api_key
bash tests/test_api.sh

---

BookFusion Back Sync

Calibre-плагин, который читает даты последнего чтения из BookFusion и записывает их в выбранную custom-колонку Calibre (тип Date).

Установка: скачать BookfusionBackSync.zip → Calibre Preferences → Plugins → Load plugin from file.

Подробнее — в BookfusionBackSync/readme.md.