API на сървъра Calibre — проучване
Техническа и проектна документация. Този документ съдържа проучванията и предложената архитектура. Не всички описани функции са непременно налични; ръководството за потребителя и кодът уточняват текущата операция.
Проучване, проведено на 30 октомври 2026 г. от изходния код на Calibre (src/calibre/srv/), няма документация: не съществува. Реализирано и покрито от тестове в Packages/Core/Sources/CalibreKit.
1. Предупреждение, което идва от самия поддържащ
На въпрос за документацията за API /ajax, Ковид Гоял отговаря, че не съществува, че тази повърхност не е нито публична, нито стабилна и че изходният код трябва да бъде прочетен. Последиците, отбелязани в CalibreKit :
- всяко декодиране е толерантно — липсващо, неочаквано поле или
nullникога не води до неуспех на списъка с библиотеки; - естеството на сървъра се открива при разклоняване (
detectFlavor()), защото Calibre-Web връща 404 за всичко/ajax/*и предлага само OPDS ; - OPDS остава резервната опция, която е стандартизирана и стабилна;
- тестовете замразяват действителните форми на байтовете, така че надграждане на версията на Calibre ще повреди теста, а не приложението.