İçeriğe geç

Sözlük · Güncellendi

E-imza API'si

E-imza API'si, yazılımların imza taleplerini web uygulaması yerine program aracılığıyla oluşturmasını, göndermesini, takip etmesini ve indirmesini sağlar.

E-imza API'si ne demek?

E-imza API'si, kendi yazılımınızın belgeleri imzaya göndermesini, durumlarını takip etmesini ve imzalı dosyaları almasını sağlayan bir programlama arayüzüdür; kimsenin sağlayıcının web uygulamasında tek tek tıklaması gerekmez. Kısacası geliştiricilerin imzalamayı otomatikleştirip CRM'lere, İK sistemlerine ve özel ürünlere bağlamasının yoludur.

Tipik bir entegrasyon şöyle işler: sisteminiz bir API anahtarıyla kimliğini doğrular, bir PDF'ten veya bir şablondan imza talebi oluşturmak için istek gönderir, imzalayanları ve sıralarını listeler ve karşılığında bir kimlik (ID) alır. Sağlayıcı ardından imzalayanlara e-posta gönderir ya da gömülü imzalama için bir URL döndürür. Bir imza veya ret gibi bir değişiklik olduğunda sağlayıcı webhook'unuzu çağırır, sisteminiz de tamamlanan belgeyi ve denetim kaydını indirir.

Her hafta serbest çalışan yerleştiren bir personel ajansını düşünün. Bir işe alım uzmanının her sözleşmeyi elle yüklemesi yerine, aday takip sistemi yerleştirme onaylandığı anda API'yi çağırır, şablonu çalışanın bilgileriyle doldurur ve imzalı kopyayı otomatik olarak aday kaydına geri dosyalar.

Bir yanılgı, API'nin yalnızca büyük kurumlar için olduğudur. Tek bir tekrar eden iş akışı olan küçük ekipler de fayda görebilir ve kod gerektirmeyen araçlar çoğu zaman API'yi sizin yerinize çağırabilir. Bir diğeri de API ile imzalanan belgelerin hukuken bir şekilde farklı olduğudur; aynı denetim kaydına sahip aynı imzalardır, yalnızca kodla başlatılmışlardır.

API, gömülü imzalamanın ve çoğu zaman toplu gönderimin temelidir; belgelerin tutarlı biçimde üretilebilmesi için genellikle şablonların üzerine kurulur.

Herhangi bir e-imza API'sini değerlendirirken pratik ayrıntılara bakın: açık dokümantasyon, bir sandbox veya test modu, makul istek sınırları, webhook yeniden denemeleri ve hem imzalı PDF'i hem de denetim kaydını indirebilme. Hataların nasıl bildirildiğini ve API'nin ekibinizin web uygulamasında yönettiği şablonları kullanıp kullanamadığını kontrol edin. Bir entegrasyonun bir gün mü yoksa bir ay mı süreceğini ve yayından sonra sessizce çalışmaya devam edip etmeyeceğini bu ayrıntılar belirler.

Bizim görüşümüz: imzalama, yazılımınızın zaten yürüttüğü bir süreçteki bir adımsa API gerçek saatler kazandırır ve kopyala-yapıştır hatalarını önler. Haftada birkaç sözleşme gönderiyorsanız web uygulamasını kurmak daha hızlı, sürdürmek daha kolaydır.

eSignSimple REST API'si yayında: bir Bearer API anahtarıyla kimlik doğrulayın, bir PDF'ten veya şablondan belge oluşturup gönderin, durumu ve denetim kaydını takip edin, imzalı PDF'i indirin ve belgeler tamamlandığında, reddedildiğinde veya iptal edildiğinde webhook alın. SDK'lar, sandbox ve gömülü imzalama yol haritamızda. Tamamlanan her belge bir denetim kaydı, bir tamamlanma sertifikası ve herkese açık sayfamızda doğrulanabilen bir SHA-256 özeti içerir. Tam referans geliştirici dokümantasyonu sayfamızda.

E-imza API'si için bir örnek nedir?

Küçük bir SaaS şirketi, her yeni kurumsal müşterinin bir sipariş formunu otomatik olarak imzalamasını istiyor. CRM'de bir fırsat kazanıldı olarak işaretlendiğinde bir betik, API anahtarıyla eSignSimple REST API'sini çağırır, müşterinin bilgileriyle sipariş formu şablonundan bir belge oluşturur ve gönderir. Belge tamamlandığında bir webhook sistemlerine haber verir ve betik imzalı PDF'i müşteri kaydına indirir.

Hangi terimlerle ilgili?

  • Şablon: E-imza şablonu, imzalayan rolleri ve alanları önceden ayarlanmış, aynı sözleşmeyi her seferinde yeniden kurmadan tekrar tekrar göndermenizi sağlayan yeniden kullanılabilir bir belgedir.
  • Toplu gönderim: Toplu gönderim, tek bir belgeyi veya şablonu aynı anda birçok alıcıya göndermenizi sağlar; her kişi kendi bireysel kopyasını alır ve imzalar.
  • Web formu (imza bağlantısı): E-imzada web formu, herkese açık bir bağlantısı olan ve herkesin önceden davet edilmeden bir belgeyi doldurup imzalamasını sağlayan barındırılan bir sayfadır.
  • Gömülü imzalama (embedded signing): Gömülü imzalama, kişilerin e-posta bağlantısıyla e-imza sağlayıcısının sitesine gitmek yerine belgeleri doğrudan sizin web sitenizde veya uygulamanızda imzalamasını sağlar.

Sık sorulan sorular

eSignSimple API'sinde kimlik doğrulama nasıl yapılır?

Hesap ayarlarınızda bir API anahtarı oluşturun ve her isteğin Authorization başlığında Bearer token olarak gönderin. Anahtarlar es_live_ ile başlar ve bir parola gibi gizli tutulmalı, ortam değişkenlerinde saklanmalı ve asla istemci tarafı koda konmamalıdır. Bir anahtarı istediğiniz zaman iptal edebilirsiniz.

eSignSimple API'siyle neler yapabilirim?

Bir PDF'ten veya şablondan belge oluşturabilir, imzalayan ekleyebilir, gönderebilir, durumu takip edebilir, denetim kaydını okuyabilir ve nihai imzalı PDF'i indirebilirsiniz. Webhook'lar, bir belge tamamlandığında, reddedildiğinde veya iptal edildiğinde sunucunuzu bilgilendirir. Uç noktaların tüm ayrıntıları /developers sayfasındadır.

eSignSimple SDK veya sandbox sunuyor mu?

Henüz değil. REST API, HTTP isteği yapabilen her dille çalışır, ancak bugün resmî SDK'lar veya ayrı bir sandbox ortamı yayımlamıyoruz. İkisi de yol haritamızda. Test için birçok geliştirici belgeleri kendi e-posta adreslerine gönderiyor.

Bir sonraki belgenizi bugün imzalatın.

Ayda 5 ücretsiz belgeyle başlayın. Kredi kartı gerekmez.