Tanpa masuk: bagaimana batas laju anonim menjaga alat gratis tetap gratis

PDF123 mempertahankan jalur unggah-dan-unduh tanpa akun. Operasi yang sama juga tersedia di bawah /api/v1/, sehingga skrip bisa memanggilnya tanpa ada orang yang mengklik Process. Pemakaian anonim tidak memerlukan API key. Batas laju mencegah permukaan itu berubah menjadi penyedia gratis tanpa batas.

Anonim adalah jalur default

Jatuhkan berkas di halaman alat seperti Compress atau Merge lalu jalankan. REST anonim di bawah /api/v1/ bekerja dengan cara yang sama untuk alat katalog. Titik akhir di bawah /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/, dan /api/v1/filter/ adalah prefiks alat anonim; setiap alat katalog di portal dipetakan ke jalur tersebut.

Fitur masuk disediakan agar Anda bisa membuat API key pribadi untuk otomasi, bukan agar Process berubah menjadi dinding pembayaran. Formulir browser dan kontrak HTTP tetap selaras: blok "Call this from code" di setiap halaman alat menyusun curl dari field yang sama dengan yang dikirim formulir.

Rute admin, profil pengguna, dan rute non-alat lainnya berada di luar prefiks itu. Pemanggil anonim yang menyentuh jalur terbatas akan mendapat kegagalan autentikasi, bukan akses gratis ke seluruh permukaan API.

Apa yang disampaikan header

Setiap respons API hosted menyatakan anggarannya (diimplementasikan di pdfx-server):

• X-RateLimit-Limit: batas periode yang dinyatakan untuk respons ini
• X-RateLimit-Remaining: anggaran yang tersisa pada periode berjalan
• X-RateLimit-Reset: penanda reset untuk jendela waktu tersebut (bacalah nilainya; jangan menganggapnya satu hari kalender)

Pada HTTP 429, Retry-After memberi tahu klien yang sopan kapan harus mencoba lagi. Kegagalan kuota memakai kode problem terstruktur rate_limited di Galat API di Developers, dengan bentuk application/problem+json yang sama seperti kegagalan API lainnya. Skrip bisa bercabang berdasarkan kode itu tanpa perlu mengikis halaman galat HTML.

Batas numeriknya bisa berubah mengikuti pengaturan penerapan. Header pada respons tertentu adalah sumber kebenarannya, bukan cuplikan di artikel blog. Klien yang menetapkan angka harian secara hard-code dari artikel ini akan salah begitu operator menyetel ulang periodenya. Lebih baik baca X-RateLimit-Remaining setelah setiap panggilan dan mundur saat nilainya mendekati nol.

Mengapa alat gratis tetap membatasi pemanggil

Tanpa batas, titik akhir anonim berubah menjadi ladang batch milik orang lain. Batas menjaga pekerjaan sekali pakai tetap bisa dipakai, sementara beban yang lebih berat atau bersifat privat berpindah ke key atau self-host.

Batas itu juga melindungi CPU bersama untuk operasi yang memang mahal: penggabungan besar, OCR yang mengembalikan Markdown dari hasil pindai (text/markdown, bukan PDF berlapis teks), dan menjalankan POST /api/v1/pipeline bertahap. Pilihan produknya adalah "anonim dan terbatas", bukan "anonim dan tanpa batas".

Akses anonim tetap merupakan pemrosesan sementara: berkas yang diunggah ditangani untuk tugas itu lalu dibersihkan begitu hasilnya siap. Pembatasan laju adalah soal keadilan kapasitas, bukan alasan untuk menciptakan penyimpanan dokumen jangka panjang di balik dinding login gratis.

Key mengubah identitas, bukan katalog

Buat key dari Developers bila Anda membutuhkan identitas pemanggil yang stabil, percobaan ulang dengan Idempotency-Key yang tidak boleh menjalankan pekerjaan dua kali, atau server self-host dengan global key tetap (SECURITY_CUSTOMGLOBALAPIKEY di mesin Anda). OpenAPI tetap ada di /v1/openapi.json pada base URL mana pun yang Anda pakai.

MCP di /mcp mengikuti katalog yang sama dan aturan key yang sama untuk klien otomasi. Operasinya tetap sama, baik pemanggilnya anonim maupun memakai key. Yang berubah hanyalah autentikasi dan kuota.

Untuk empat cara memanggil satu operasi (browser, curl, MCP, CLI), lihat Operasi yang sama, empat klien. Untuk memindahkan seluruh permukaan ke jaringan Anda sendiri ketika batas atau retensi tidak lagi cukup, lihat Apa yang sebenarnya Anda dapat dari self-host.