Tanpa Log Masuk: Had Kadar Tanpa Nama Mengekalkan Alat Percuma Kekal Percuma

PDF123 mengekalkan laluan muat naik dan muat turun tanpa akaun. Operasi yang sama juga berada di bawah /api/v1/ supaya skrip boleh memanggilnya tanpa perlu ada orang mengklik Process. Penggunaan tanpa nama tidak memerlukan kunci API. Had kadar menghalang permukaan itu daripada menjadi hos percuma yang tidak terbatas.

Tanpa nama ialah laluan lalai

Lepaskan fail pada halaman alat seperti Mampatkan PDF atau Gabungkan PDF lalu jalankannya. REST tanpa nama di bawah /api/v1/ berfungsi dengan cara yang sama untuk alat katalog. Laluan di bawah /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/, dan /api/v1/filter/ ialah awalan alat tanpa nama; setiap alat katalog dalam portal dipetakan ke laluan tersebut.

Log masuk wujud supaya anda boleh mencipta kunci API peribadi untuk automasi, bukan supaya Process menjadi tembok bayaran. Borang pelayar dan kontrak HTTP kekal selaras: blok “Call this from code” pada setiap halaman alat membina curl daripada medan yang sama yang dihantar oleh borang.

Laluan admin, profil pengguna, dan laluan bukan alat berada di luar awalan tersebut. Pemanggil tanpa nama yang menghantar permintaan ke laluan berkawalan akan menerima kegagalan pengesahan, bukan laluan percuma merentasi seluruh permukaan API.

Apa yang dinyatakan oleh pengepala

Setiap respons API yang dihoskan menyatakan bajetnya (dilaksanakan pada pdfx-server):

• X-RateLimit-Limit: had bagi tempoh tersebut untuk respons ini
• X-RateLimit-Remaining: bajet yang tinggal dalam tempoh semasa
• X-RateLimit-Reset: penanda set semula untuk tetingkap itu (bacalah nilainya; jangan andaikan sehari kalendar)

Pada HTTP 429, Retry-After memberitahu klien yang berhemah bila perlu cuba lagi. Kegagalan kuota menggunakan kod masalah berstruktur rate_limited di bawah Ralat API, dengan bentuk application/problem+json yang sama seperti kegagalan API yang lain. Skrip boleh bercabang berdasarkan kod itu tanpa perlu mengikis halaman ralat HTML.

Had berangka hanya berubah mengikut tetapan pemasangan. Pengepala pada respons tertentu itulah sumber kebenaran, bukan petikan blog. Klien yang menetapkan secara tetap nombor harian daripada artikel ini akan tersalah apabila seorang operator melaraskan semula tempohnya. Lebih baik baca X-RateLimit-Remaining selepas setiap panggilan dan kurangkan kadar permintaan apabila nilainya menghampiri sifar.

Mengapa alat percuma masih mengehadkan pemanggil

Tanpa had, laluan tanpa nama akan menjadi ladang pemprosesan kelompok orang lain. Had mengekalkan kerja sekali sekala tetap boleh digunakan sementara beban yang lebih berat atau peribadi beralih kepada kunci atau self-host.

Had juga melindungi CPU yang dikongsi untuk operasi yang benar-benar mahal: gabungan besar, OCR yang memulangkan Markdown daripada imbasan (text/markdown, bukan PDF yang dilapisi semula dengan lapisan teks), dan pelaksanaan POST /api/v1/pipeline berbilang langkah. Pilihan produknya ialah “tanpa nama dan terbatas,” bukan “tanpa nama dan tanpa had.”

Akses tanpa nama masih merupakan pemprosesan sementara: muat naik dikendalikan untuk tugasan itu lalu dibersihkan apabila hasilnya sedia. Had kadar ialah tentang keadilan kapasiti, bukan tentang mencipta storan dokumen jangka panjang di sebalik dinding log masuk percuma.

Kunci mengubah identiti, bukan katalog

Cipta kunci di Pembangun apabila anda memerlukan identiti pemanggil yang stabil, cubaan semula Idempotency-Key yang tidak boleh menjalankan kerja dua kali, atau pelayan self-host dengan kunci global yang tetap (SECURITY_CUSTOMGLOBALAPIKEY pada kotak anda). OpenAPI kekal di /v1/openapi.json pada mana-mana URL asas yang anda gunakan.

MCP di /mcp mengikuti katalog yang sama dan kaedah kunci yang sama untuk klien automasi. Operasinya kekal sama sama ada pemanggilnya tanpa nama atau berkunci. Pengesahan dan kuota itulah yang berubah.

Untuk empat cara mencapai satu operasi (pelayar, curl, MCP, CLI), lihat Operasi sama, empat klien. Untuk memindahkan seluruh permukaan ke rangkaian anda apabila had atau pengekalan tidak mencukupi, lihat Apa yang sebenarnya anda peroleh daripada self-host.