PPDF123
How-to3 menit baca

Ekspor tabel kosong (204): PDF Anda kemungkinan tanpa kolom

PDF to Excel dan PDF to CSV mengembalikan HTTP 204 saat tidak ada blok tabel terdeteksi, dan itu disengaja, bukan kegagalan; jalankan OCR dulu untuk hasil pindai.

By the PDF123 team Β· Updated 2026-10-02
Ekspor tabel kosong (204): PDF Anda kemungkinan tanpa kolom

Jika PDF to Excel atau PDF to CSV selesai dengan HTTP 204 No Content dan tanpa body unduhan, ekstraktornya menemukan nol blok tabel. Status itu memang disengaja: API menolak menciptakan spreadsheet kosong ketika heuristik tata letaknya tidak melihat kolom.

Apa yang dicari ekstraktor

Kedua alat memakai alur yang sama. Server menjalankan pdftotext -layout, memecah halaman pada batas form-feed, lalu mengelompokkan baris yang tampak seperti blok berkolom. Sebuah baris dianggap tabular bila memuat setidaknya dua spasi berturut-turut (celah antarkolom pada mode layout). Sebuah blok hanya dipertahankan bila memiliki setidaknya dua baris seperti itu; satu baris berjarak dibuang agar judul tidak berubah menjadi "tabel" satu baris.

PDF to CSV (POST /api/v1/convert/pdf/csv) menghasilkan satu CSV untuk setiap tabel yang terdeteksi (dinamai dengan indeks halaman dan tabel), atau ZIP bila ada beberapa. PDF to Excel (POST /api/v1/convert/pdf/xlsx) menulis satu workbook dengan satu sheet per tabel yang terdeteksi.

Ketika daftar itu kosong, keduanya mengembalikan Output::no_content() yang dipetakan ke 204. Respons 200 dengan berkas .xlsx kosong lebih mudah disalahartikan sebagai keberhasilan; 204 berarti "tidak ada yang bisa diekspor".

Alasan umum munculnya 204

  • PDF hanya berisi prosa: teks naratif tanpa perataan kolom yang jelas. Gunakan PDF to Text atau PDF to Markdown sebagai gantinya.
  • Halaman hasil pindai tanpa lapisan teks: keluaran pdftotext kosong, sehingga tidak ada tabel yang muncul. Jalankan OCR lebih dulu (menghasilkan teks Markdown di situs ini), lalu coba lagi hanya jika kata-katanya memang membentuk kolom.
  • Tabel yang digambar hanya sebagai garis atau gambar: kisi visual tanpa teks sel yang bisa diekstrak tidak akan menjadi sheet.
  • Tata letak majalah banyak kolom yang berantakan: heuristiknya bisa melewatkan blok yang oleh manusia disebut "tabel", atau menggabungkan urutan bacanya dengan buruk.
  • "Tabel" satu baris: satu baris berjarak tidak akan pernah menjadi blok; Anda memerlukan setidaknya dua baris tabular.

Berkas terenkripsi memerlukan Unlock yang sah sebelum ekstraksi. Perbaiki berkas yang rusak dengan Repair bila Get Info atau ekspornya tidak bisa membukanya.

Apa yang bukan 204

204 bukan kegagalan transport, bukan timeout, dan bukan tanda "server lupa melampirkan berkas". Perlakukan itu sebagai keputusan yang berhasil: tidak ada blok tabel. Mencoba ulang berkas yang sama tanpa mengubah lapisan teks atau tata letaknya akan mengembalikan 204 lagi. Skrip harus bercabang berdasarkan kode status, bukan berdasarkan nama berkas yang kosong.

Markdown hasil OCR adalah ekstraksi teks untuk agen, bukan spreadsheet. Jika Anda menempelkan keluaran OCR ke berkas .md dan nanti membutuhkan kolom, Anda tetap memerlukan tata letak yang bisa dibaca pdftotext -layout (atau manusia) sebagai celah antarkolom; mengekspor ulang PDF hasil pindai yang sama tanpa lapisan teks akan terus mengembalikan 204.

Apa yang harus dilakukan berikutnya

  1. Buka PDF-nya dan pastikan Anda bisa memilih teks sel. Jika tidak, jalankan OCR, lalu putuskan apakah teks yang dipulihkan cukup berkolom untuk heuristik ini.
  2. Utamakan PDF to Excel bila Anda memperkirakan ada beberapa tabel (masing-masing satu sheet). Utamakan PDF to CSV untuk satu berkas datar atau ZIP berisi CSV.
  3. Jika halamannya naratif, ganti alatnya; ekspor tabel akan terus mengembalikan 204.
  4. Untuk penanganan status di agen atau pipeline, petakan 204 menjadi "tidak ada tabel terdeteksi", bukan loop percobaan ulang yang generik.
  5. Jika Anda hanya membutuhkan kata-katanya, berhenti di PDF to Text atau PDF to Markdown; memaksakan bentuk spreadsheet pada prosa akan terus mengembalikan 204.

Jalur browser tidak memerlukan akun. Titik akhir yang sama lewat HTTP: Developers. Kirim Idempotency-Key pada percobaan ulang bila klien Anda mungkin POST dua kali (Idempotency-Key).

Open tool
Process in the browser β€” no watermark, files removed after the job.
Open tool