Apa yang Diekspos API PDF Kami — Kredit dan Batasan

Halaman API cenderung berkembang lebih cepat dibandingkan API. Rute kami sekarang hanya mencantumkan rute yang selesai tanpa browser: akun, Sunting, dan Bandingkan. Itu disengaja. Titik akhir yang tidak dapat menyelesaikan alur kerjanya lebih buruk daripada tidak ada titik akhir sama sekali.

Apa yang ditayangkan hari ini

• DAPATKAN /v1/saya — saldo akun, paket, dan kredit langsung; 1 pulsa per panggilan.
• POST /v1/redact-pdf — temukan pola, teks atau gambar, dan kembalikan PDF yang telah disunting apply=1. Bebas.
• POST /v1/bandingkan-pdf — statistik, perubahan blok, dan perbedaan utama antara dua PDF. Bebas.

Ketiganya mengambil kunci pembawa dari Akun Saya. Hasilnya adalah JSON dengan tautan unduhan yang bertahan selama dua jam; dokumen asli tidak pernah diubah pada tempatnya.

Apa yang tidak ada di API

Berapa tarif API hari ini

Hanya ada tiga rute: GET /v1/me biaya 1 kredit, sedangkan POST /v1/redact-pdf dan POST /v1/compare-pdf biaya masing-masing 5 kredit. Tidak ada biaya penggabungan atau API OCR karena alat tersebut bukan titik akhir API. Tarif langsung ada di Paket & harga halaman.

Mengapa E-Signer bukan rute

Penandatanganan adalah alur kerja browser dua kali lipat: pengirim menempatkan bidang pada halaman, dan penerima membuka tautan dan menandatangani. Klien HTTP tidak dapat melihat tata letak atau mengoperasikan halaman tersebut, sehingga “API tanda tangan elektronik” akan berhenti sebelum pekerjaan selesai. Amplop ada di dashboard E-Signer; API tidak membuat atau menandatanganinya.

Kunci dan retensi file

Perlakukan kunci API seperti kata sandi: satu kunci per aplikasi, putar kunci tersebut jika telah ditempelkan ke repositori publik, dan jangan pernah meletakkannya di JavaScript sisi browser. File yang diunggah adalah copy pekerjaan sementara dengan id yang tidak dapat ditebak; mereka bukan toko dokumen. Simpan dokumen asli di penyimpanan Anda sendiri dan perlakukan respons API sebagai salinan turunan. Itu Halaman keamanan mencantumkan kontrol dan jendela retensi.

Apa yang harus diukur sebelum melakukan peningkatan

Lacak tiga nomor selama sebulan: panggilan berhasil, panggilan gagal, dan saldo pulsa di akhir. Redact dan Compare dibayar (masing-masing 5 sks), sehingga bulan sibuk terlihat di saldo; biaya panggilan akun 1. Jika percobaan ulang atau lonjakan pada bulan puncak memang menghabiskan kredit, paket yang lebih besar akan lebih murah daripada paket yang gagal. Karena pulsa yang belum terpakai bergulir, bulan tenang tidak terbuang percuma.

E-Signer hanya untuk browser. Seseorang harus menempatkan bidang tanda tangan penerima secara visual, dan penerima harus membuka halaman penandatanganan dan menandatanganinya. Klien HTTP tidak dapat melakukan keduanya, jadi tidak ada rute API untuk membuat, menandatangani, membuat daftar, atau amplop polling. Dasbor E-Signer tetap menjadi tempat yang tepat untuk pekerjaan itu.

Pengujian yang sama menghapus penggabungan, kompresi, konversi, dan editor dari API untuk saat ini: alur kerjanya yang bermanfaat bersifat interaktif dan banyak file. Mereka tetap bebas di browser daripada diiklankan sebagai titik akhir yang setengah berfungsi.

Apa yang dibeli dengan kredit

Kredit adalah saldo prabayar yang melekat pada akun Komersial. Saat ini satu-satunya rute API berbayar adalah GET /v1/me pada 1 sks dan Redaksi dan Bandingkan masing-masing 5 sks. Paket masih mencakup tunjangan kredit bulanan, dan kredit yang belum terpakai akan diperpanjang dan bukannya habis masa berlakunya. Kami mencantumkan tarif API langsung di Paket & harga halaman dan jangan publikasikan harga per alat untuk rute yang tidak ada.

Kunci, batasan dan keamanan

Kunci API ditampilkan satu kali dan disimpan hanya sebagai hash. Kunci yang dicabut akan langsung berhenti bekerja. Jawaban batas kecepatan per kunci dan per IP 429 dengan Retry-After, unggahan dibatasi berdasarkan ukuran dan jumlah halaman, dan akun yang diblokir atau tidak memiliki hak tidak dapat menggunakan kunci aktif. Itu halaman API mendokumentasikan tiga rute dan bidang permintaannya.

Memulai

Buat akun, aktifkan paket Komersial jika Anda memerlukan kunci API, lalu buat kunci di Akun Saya dan telepon GET /v1/me pertama. Jika alat browser dapat melakukan tugasnya, gunakan alat browser tersebut — alat tersebut tetap gratis.