Naprawa PDF online a wyszukiwania „Recovery Toolbox”: co PDF123 faktycznie robi
Wyszukiwania „PDF recovery toolbox” często oznaczają naprawę struktury. Repair PDF w PDF123 to darmowe narzędzie online i API, a nie desktopowy Recovery Toolbox.

Gdy PDF się nie otwiera, wyniki wyszukiwania często mieszają dwie różne sprawy: naprawę struktury uszkodzonego pliku oraz markowe, desktopowe oprogramowanie „do odzyskiwania”. PDF123 (pdf123.xyz), publikowany jako PDF Toolbox, oferuje to pierwsze jako darmowe narzędzie online i API Repair PDF. Nie jest to produkt na Windows sprzedawany pod nazwą Recovery Toolbox for PDF.
Co „naprawa” oznacza dla uszkodzonego PDF
PDF, który zgłasza „file is damaged” albo odmawia otwarcia, zwykle ma zepsutą wewnętrzną mapę (problemy z cross-reference lub strumieniem obiektów), a nie brakujące obrazy stron, które dałoby się przerysować ręcznie. Napraw PDF (POST /api/v1/misc/repair) odbudowuje tę strukturę, przepisując plik przez qpdf z bajtów, które są jeszcze poprawne. Gdy odzyskiwanie się powiedzie, przeglądarki mogą znów otworzyć plik bez zmiany zamierzonej treści stron.
To co innego niż:
- OCR i czyszczenie skanu — plik się otwiera, ale tekst istnieje tylko jako obraz (OCR w tym serwisie zwraca Markdown, a nie ukrytą warstwę tekstu)
- Odblokowanie hasłem — plik jest zaszyfrowany, a hasło już znasz (Odblokuj)
- Desktopowe zestawy do odzyskiwania — instalowane aplikacje do głębokiego odzyskiwania na lokalnej maszynie
- Kompresja i konwersja — narzędzia rozmiaru i formatu, które najpierw potrzebują pliku dającego się sparsować
Online toolbox a zapytania o desktopowy „Recovery Toolbox”
| Potrzeba | PDF123 Repair PDF | Typowy desktopowy produkt do odzyskiwania |
|---|---|---|
| Sposób uruchomienia | Przesłanie w przeglądarce lub HTTP API | Instalacja i uruchomienie na własnym komputerze |
| Główne zadanie | Naprawa struktury, aby PDF się otwierał | Procesy odzyskiwania zależne od dostawcy (różne w różnych produktach) |
| Automatyzacja | Repair PDF API pod POST /api/v1/misc/repair |
Zwykle GUI lub lokalna partia, nie nasze OpenAPI |
| Konto | Nie jest wymagane w przypadku narzędzi z katalogu | Zależy od dostawcy |
Nie twierdzimy, że mamy parytet funkcji, cenę czy szczegóły wersji Recovery Toolbox for PDF: ten produkt jest odrębny. Ta tabela wyjaśnia wyłącznie kanał i intencję: naprawę przez API online kontra markę desktopowego odzyskiwania, którą ktoś mógł wpisać w Google.
Wstępna kontrola przed naprawą
Pobierz informacje zwraca kontrolę wstępną w formacie JSON (FileSize, PageCount, Encrypted, pola Info, wersję). Dzięki niej sprawdzisz, czy parser potrafi wczytać plik i czy szyfrowanie nie blokuje innych edycji. Naprawa nie usuwa haseł. Drzewo decyzyjne krok po kroku dla sytuacji „plik się nie otwiera” znajdziesz w Plik się nie otwiera: informacje, naprawa, koniec zgadywania.
Kiedy naprawa, a kiedy OCR
- Przeglądarka w ogóle nie otwiera pliku → najpierw wypróbuj Napraw PDF.
- Plik się otwiera, ale na skanie nie da się zaznaczyć ani wyszukać tekstu → użyj OCR i czyszczenia skanu, aby dostać tekst w Markdown; osobno uruchom kompresję, jeśli liczy się rozmiar (Proces pakietu skanów).
- Tej samej naprawy potrzebujesz w skrypcie albo u agenta → wywołaj Repair PDF API; klucze i OpenAPI opisuje Dla programistów. Przy ponownych próbach dodaj
Idempotency-Key(Idempotency-Key).
Jak wygląda sukces
Po naprawie przeglądarka powinna otworzyć plik bez błędu „damaged PDF”, jeśli wystarczająca liczba obiektów przetrwała. Liczba stron z Pobierz informacje powinna zgadzać się z oczekiwaną dla oryginału, gdy struktura odzyskała się czysto. Jeśli plik nadal się nie otwiera, kolejne wywołania Compress, OCR czy konwersji nie wymyślą brakujących bajtów. Zatrzymaj się i zachowaj oryginał dla narzędzi śledczych spoza tego katalogu, jeśli wymaga tego twoja polityka.
Wypróbuj
Prześlij uszkodzony plik na Napraw PDF albo wywołaj POST /api/v1/misc/repair z kluczem API. Trzymaj uszkodzony oryginał obok naprawionego pliku. Dostęp dla agentów (MCP, potok, OpenAPI) zaczyna się od Dla programistów.