Dosya açılmıyor: Get Info, Repair, sonra tahmin etmeyi bırakın
PDF açılmıyorsa ön kontrol için Get Info, sonra yapısal yeniden kurulum için Repair çalıştırın. Bu xref kurtarmadır; masaüstü Recovery Toolbox klonu değildir.

Açılmayan bir PDF çoğu zaman bir yapı sorunudur (kırık çapraz başvuru tablosu, kesilmiş indirme, bozuk nesneler); elle yeniden çizebileceğiniz eksik bir sayfa görüntüsü değil. OCR, sıkıştırma veya dönüştürmeyle tahmin etmek, dosya ayrıştırılana kadar zaman kaybettirir.
Önce Get Info
Get Info (POST /api/v1/security/get-info-on-pdf) bir JSON raporu döner: FileSize, PageCount, Encrypted, varsa Info sözlüğü alanları (title, author, subject, creator, producer), PDF Version, basit bir Pages listesi ve bir belge kökü bulunup bulunmadığı. Bunu ön kontrol olarak kullanın:
- Encrypted: true, çoğu düzenlemeden önce yetkili bir Unlock gerektiği anlamına gelir; tek başına repair parolaları kırmaz.
- PageCount / FileSize makul görünüyor ama masaüstü görüntüleyiciniz yine başarısız oluyor: sırada yapısal Repair deneyin.
- Çağrının kendisi baytları yükleyemiyor: dosya temiz bir Info geçişi için fazla hasarlı olabilir; yine de bir kopya üzerinde Repair deneyin.
Get Info PDF’yi yeniden yazmaz. Ayrıştırıcının ne görebildiğini söyler; böylece her başarısızlığı “OCR gerek” veya “sıkıştırma gerek” diye ele almayı bırakırsınız.
Sonra Repair (qpdf ile yapısal yeniden kurulum)
Repair PDF (POST /api/v1/misc/repair), yeterli nesne kaldığında görüntüleyicilerin dosyayı yeniden açabilmesi için dosyayı qpdf üzerinden yeniden yazar. İşe yaradığında amaçlanan sayfa içeriği korunur; iş, dosyanın haritasıdır (xref / nesne akışları), silinmiş taslakların adli kurtarılması değil.
Repair şunlar değildir:
- OCR / tarama temizliği (dosya açılır ama metin yalnızca görüntüdür): OCR kullanın; burada aranabilir bir PDF katmanı değil Markdown metni döner
- Parola kaldırma: Unlock kullanın
- Yazı tipi onarımı veya “dosyayı yeniden düzenlenebilir yapma”
- “Recovery Toolbox for PDF” Windows ürününün bir klonu
Marka ve kanal ayrımı (çevrimiçi yapısal onarım ile masaüstü “recovery toolbox” aramaları) için Çevrimiçi PDF onarımı ile Recovery Toolbox aramaları yazısını okuyun.
Tahmin etmeyi bırakma karar ağacı
- Görüntüleyici dosyayı açamıyor: Get Info, sonra Repair.
- Dosya açılıyor ama bir taramada seçme/arama başarısız: Markdown metni için OCR; kalan sorun boyutsa isteğe bağlı olarak bir kopyayı Compress edin (Tarama paketi: önce OCR, sonra Compress).
- Dosya açılıyor, tablolar 204 olarak dışa aktarılıyor: sütun algılanmadı; Boş tablo dışa aktarma (204) yazısına bakın.
- Aynı onarımı bir betikten veya ajandan: Geliştiriciler üzerinden
POST /api/v1/misc/repair. İstemciniz yüklemeleri yeniden deniyorsa birIdempotency-Keygönderin (Idempotency-Key).
“Onarıldı” yine neyi düzeltmez
Başarılı bir Repair, bir görüntüleyicinin dosyayı yeniden açabileceği anlamına gelir. Şu anlamlara gelmez:
- Her sayfa görüntüsü yoktan yeniden kuruldu (eksik nesneler eksik kalır)
- Bir taramada metin seçilebilir hâle geldi (burada bu OCR → Markdown’dır)
- Şifreleme ortadan kayboldu (bilinen bir parolayla Unlock)
- Tablolar dışa aktarılacak (yine sütunlu metin gerekir; 204 hiç algılanmadı demektir)
Repair’den sonra Get Info makul bir sayfa sayısı gösteriyor ama bir sayfa boşsa, yapı kurtarılmıştır ve o sayfanın içeriği özgün baytlarda hâlâ boş veya kesilmiş olabilir.
Hasarlı özgünü saklayın
Hasarlı özgünü, onarılmış her türevin yanında saklayın. Repair yeterli yapıyı kurtaramıyorsa dürüst sonuç “baytlar gitti”dir, katalogdaki bir sonraki rastgele araç değil. Hâlâ ayrıştırılamayan bir dosyayı sıkıştırmak veya dönüştürmek eksik nesneleri yaratmaz.
Aracı bu şekilde bulduysanız kanal amacını (çevrimiçi yapısal onarım ile masaüstü “recovery toolbox” marka aramaları) Çevrimiçi PDF onarımı ile Recovery Toolbox aramaları yazısında karşılaştırın. Katalog araçlarında tarayıcı yolu için hesap gerekmez.