Glosarium · Diperbarui
API tanda tangan elektronik
API tanda tangan elektronik memungkinkan software membuat, mengirim, memantau, dan mengunduh permintaan tanda tangan secara terprogram, bukan lewat aplikasi web.
Apa arti API tanda tangan elektronik?
API tanda tangan elektronik adalah antarmuka pemrograman yang memungkinkan software Anda sendiri mengirim dokumen untuk ditandatangani, memantau statusnya, dan mengambil file yang sudah ditandatangani, tanpa ada orang yang mengklik di aplikasi web penyedia. Singkatnya, inilah cara developer mengotomatiskan penandatanganan dan menghubungkannya ke CRM, sistem HR, dan produk buatan sendiri.
Integrasi yang umum berjalan seperti ini: sistem Anda melakukan autentikasi dengan kunci API, mengirim permintaan untuk membuat permintaan tanda tangan dari PDF atau templat, mencantumkan penanda tangan beserta urutannya, lalu menerima ID sebagai balasan. Penyedia kemudian mengirim email ke penanda tangan atau mengembalikan URL untuk tanda tangan tertanam. Saat ada perubahan, misalnya tanda tangan atau penolakan, penyedia memanggil webhook Anda, dan sistem Anda mengunduh dokumen yang sudah selesai beserta jejak auditnya.
Bayangkan sebuah agen penyalur tenaga kerja yang menempatkan tenaga kontrak setiap minggu. Alih-alih perekrut mengunggah setiap perjanjian secara manual, sistem pelacakan pelamar memanggil API begitu penempatan dikonfirmasi, mengisi templat dengan data tenaga kontrak, lalu menyimpan salinan bertanda tangan kembali ke data kandidat secara otomatis.
Salah satu salah kaprah adalah menganggap API hanya untuk perusahaan besar. Tim kecil dengan satu alur kerja yang berulang pun bisa mendapat manfaat, dan alat tanpa kode sering bisa memanggil API untuk Anda. Salah kaprah lainnya adalah mengira dokumen yang ditandatangani lewat API berbeda secara hukum; tanda tangannya sama dengan jejak audit yang sama, hanya dimulai oleh kode.
API adalah fondasi bagi embedded signing dan sering juga bagi kirim massal, dan biasanya dibangun di atas templat agar dokumen bisa dibuat secara konsisten.
Saat menilai API tanda tangan elektronik apa pun, perhatikan detail praktisnya: dokumentasi yang jelas, sandbox atau mode uji, batas laju (rate limit) yang wajar, pengulangan webhook, dan kemampuan mengunduh PDF bertanda tangan sekaligus jejak auditnya. Periksa bagaimana galat dilaporkan dan apakah API bisa memakai templat yang sama dengan yang dikelola tim Anda di aplikasi web. Detail-detail itulah yang menentukan apakah integrasi selesai dalam sehari atau sebulan, dan apakah ia tetap berjalan tenang setelah diluncurkan.
Pendapat kami: jika penandatanganan adalah satu langkah dalam proses yang sudah dijalankan software Anda, API menghemat banyak jam kerja dan mencegah kesalahan salin-tempel. Jika Anda hanya mengirim beberapa kontrak per minggu, aplikasi web lebih cepat disiapkan dan lebih mudah dirawat.
REST API eSignSimple sudah aktif: autentikasi dengan kunci API sebagai Bearer token, buat dan kirim dokumen dari PDF atau templat, pantau status dan jejak audit, unduh PDF yang sudah ditandatangani, dan terima webhook saat dokumen selesai, ditolak, atau dibatalkan. SDK, sandbox, dan embedded signing ada di peta jalan kami. Setiap dokumen yang selesai dilengkapi jejak audit, sertifikat penyelesaian, dan hash SHA-256 yang bisa diverifikasi di halaman publik kami. Referensi lengkapnya ada di halaman dokumentasi developer kami.
API tanda tangan elektronik: contoh nyata
Sebuah perusahaan SaaS kecil ingin setiap pelanggan enterprise baru menandatangani formulir pesanan secara otomatis. Saat sebuah deal ditandai menang di CRM mereka, sebuah skrip memanggil REST API eSignSimple dengan kunci API, membuat dokumen dari templat formulir pesanan dengan data pelanggan, lalu mengirimkannya. Webhook memberi tahu sistem mereka saat dokumen selesai, dan skrip mengunduh PDF yang sudah ditandatangani ke data pelanggan.
Istilah apa saja yang terkait?
- Templat: Templat tanda tangan elektronik adalah dokumen yang dapat dipakai ulang dengan peran penanda tangan dan kolom yang sudah diatur, sehingga perjanjian yang sama bisa dikirim berulang kali tanpa menyiapkannya dari awal.
- Kirim massal (bulk send): Kirim massal memungkinkan Anda mengirim satu dokumen atau templat ke banyak penerima sekaligus, dan setiap orang menerima serta menandatangani salinannya sendiri.
- Formulir web (tautan penandatanganan): Formulir web dalam penandatanganan elektronik adalah halaman isi-dan-tanda-tangani dengan tautan publik, sehingga siapa pun bisa melengkapi dan menandatangani dokumen tanpa diundang lebih dulu.
- Tanda tangan tertanam (embedded signing): Embedded signing atau tanda tangan tertanam memungkinkan orang menandatangani dokumen langsung di dalam situs web atau aplikasi Anda sendiri, bukan lewat tautan email ke situs penyedia tanda tangan elektronik.
Pertanyaan umum
Bagaimana cara autentikasi ke API eSignSimple?
Buat kunci API di pengaturan akun Anda dan kirimkan sebagai Bearer token di header Authorization pada setiap permintaan. Kunci diawali es_live_ dan harus dirahasiakan seperti kata sandi: simpan di variabel lingkungan dan jangan pernah di kode sisi klien. Anda bisa mencabut kunci kapan saja.
Apa saja yang bisa dilakukan dengan API eSignSimple?
Anda bisa membuat dokumen dari PDF atau templat, menambahkan penanda tangan, mengirimkannya, memantau status, membaca jejak audit, dan mengunduh PDF akhir yang sudah ditandatangani. Webhook memberi tahu server Anda saat dokumen selesai, ditolak, atau dibatalkan. Detail lengkap endpoint ada di halaman /developers.
Apakah eSignSimple menyediakan SDK atau sandbox?
Belum. REST API bisa dipakai dengan bahasa pemrograman apa pun yang dapat mengirim permintaan HTTP, tetapi saat ini kami belum menerbitkan SDK resmi maupun lingkungan sandbox terpisah. Keduanya ada di peta jalan kami. Untuk pengujian, banyak developer mengirim dokumen ke alamat email mereka sendiri.
Dapatkan tanda tangan untuk dokumen Anda berikutnya hari ini.
Mulai dengan 5 dokumen gratis per bulan. Tanpa kartu kredit.