Файл не відкривається: Get Info, Repair, і годі вгадувати
Коли PDF не відкривається, запустіть Get Info для передперевірки, потім Repair для структурної відбудови. Це відновлення xref, а не настільний Recovery Toolbox.

PDF, який не відкривається, зазвичай має структурну проблему (зламана таблиця перехресних посилань, обрізане звантаження, деформовані об’єкти), а не відсутнє зображення сторінки, яке можна домалювати вручну. Вгадування через OCR, стиснення чи конвертацію гає час, доки файл не почне розбиратися.
Спершу Get Info
Отримати інформацію (POST /api/v1/security/get-info-on-pdf) повертає звіт у JSON: FileSize, PageCount, Encrypted, поля словника Info, коли вони є (title, author, subject, creator, producer), Version PDF, простий список Pages і те, чи знайдено корінь документа. Скористайтеся ним як передперевіркою:
- Encrypted: true означає, що перед більшістю редагувань потрібне дозволене розблокування; саме відновлення не зламує паролів.
- PageCount / FileSize виглядають розумно, але настільний переглядач усе одно не справляється: далі спробуйте структурне Відновлення.
- Сам виклик не може завантажити байти: файл може бути занадто пошкодженим для чистого проходу Info; усе одно спробуйте Repair на копії.
Get Info не переписує PDF. Він каже, що бачить парсер, щоб ви перестали сприймати кожен збій як «потрібен OCR» чи «потрібне стиснення».
Потім Repair (структурна відбудова через qpdf)
Відновити PDF (POST /api/v1/misc/repair) переписує файл через qpdf, щоб переглядачі знову могли його відкрити, коли лишається достатньо об’єктів. Коли це вдається, задуманий вміст сторінок зберігається; робота стосується карти файлу (xref / об’єктні потоки), а не криміналістичного відновлення видалених чернеток.
Repair — це не:
- OCR / очищення сканів (файл відкривається, але текст існує лише як зображення): скористайтеся OCR — який тут повертає текст Markdown, а не шар пошуку в PDF;
- зняття пароля: скористайтеся розблокуванням;
- відновлення шрифтів чи «повернення редагованості»;
- клон продукту для Windows «Recovery Toolbox for PDF».
Про розрізнення бренду й каналу (онлайн-структурне відновлення проти пошуку настільного «recovery toolbox») читайте Відновлення PDF онлайн проти пошуку Recovery Toolbox.
Дерево рішень «годі вгадувати»
- Переглядач не може відкрити файл: Отримати інформацію, потім Відновлення.
- Файл відкривається, але виділення й пошук на скані не працюють: OCR для тексту Markdown; за бажанням Стиснути копію, якщо розмір — залишкова проблема (Набір сканів: OCR, потім стиснення).
- Файл відкривається, таблиці експортуються як 204: колонок не виявлено; див. Порожній експорт таблиці (204).
- Те саме відновлення зі скрипта чи агента:
POST /api/v1/misc/repairчерез Розробникам. НадсилайтеIdempotency-Key, якщо ваш клієнт повторює завантаження (Idempotency-Key).
Чого «відновлений» усе одно не виправить
Успішне відновлення означає, що переглядач може знову відкрити файл. Воно не означає, що:
- кожне зображення сторінки відтворено з нічого (відсутні об’єкти лишаються відсутніми);
- текст на скані став виділюваним (це OCR → Markdown тут);
- шифрування зникло (розблокування відомим паролем);
- таблиці експортуватимуться (усе ще потрібен колонковий текст; 204 означає, що жодного не виявлено).
Якщо після відновлення Get Info показує розумну кількість сторінок, але сторінка порожня, структура відновилася, а вміст тієї сторінки міг лишитися порожнім або обрізаним у початкових байтах.
Збережіть пошкоджений оригінал
Тримайте пошкоджений оригінал поруч із будь-якою відновленою похідною. Якщо Repair не може відновити достатньо структури, чесний результат — «байти втрачено», а не ще один випадковий інструмент із каталогу. Стиснення чи конвертація файлу, який усе ще не розбирається, не вигадують відсутніх об’єктів.
Порівняйте намір каналу (онлайн-структурне відновлення проти пошуку бренду настільного «recovery toolbox») у статті Відновлення PDF онлайн проти пошуку Recovery Toolbox, якщо саме так ви знайшли інструмент. Обліковий запис для шляху через браузер в інструментах каталогу не потрібен.