eSign services Belge API'yi kullanarak tekli oturum açma
Belgeyi gönderen kişiyi belirtme
eSign services hesap yönetimi
Document Cloud eSign services Belge API, eSign services tarafından yönetilen ayrı bir kayıt işlemi yapmanız gerekmeden mevcut uygulamanıza sorunsuz şekilde entegre edilecek şekilde tasarlanmıştır. Bu nedenle, söz konusu uygulama gönderen kişinin kayıtlı bir eSign services kullanıcısı olmasından sorumludur. Gönderen kayıtlı bir kullanıcı değilse uygulama kişiyi programlı bir şekilde API kanalıyla kaydettirir. Alıcıların kaydolma zorunluluğu yoktur. Alıcı tarafında gerçekleşmesi gereken etkileşimleri her zaman eSign services yönetir.
sendDocument (Belge Gönder) yöntemiyle yeni bir işlem başlatıldığında gönderen kişiyi belirtmenin çeşitli yolları vardır. Davranış, isteğe bağlı SenderInfo (Gönderen Bilgileri) parametresinden hangi değerlerin geçtiğine bağlıdır.
Boş SenderInfo: Bu durumda, belgeyi gönderen kişi kullanılan API Anahtarıyla ilişkili tek kullanıcıdır. Bu yöntemin testlerde ve kapsamı sınırlı olan belirli uygulamalarda kullanılması uygundur; ancak, mevcut kullanıcı kümeleri olan büyük ölçekli entegrasyonlarda genelde kullanışlı değildir.
E-posta ve parola içeren SenderInfo: Bu durumda, belgeyi gönderen kişi e-posta parametresinin belirttiği kullanıcıdır. Verilen parolanın kullanıcının EchoSign parolasıyla eşleşmesi gereklidir. Entegrasyon amaçları doğrultusunda, belge gönderilmek üzereyken söz konusu uygulama bağlamında kullanıcıdan e-posta ve parola talep edilebilir. Alternatif olarak, söz konusu uygulama, kullanıcıyı kendisi oluşturduğu veya kullanıcı bu bilgileri daha önceden verdiği ve bilgiler önbelleğe alındığı için e-posta ve parolayı hatırlayabilir.
E-posta içeren ve parola içermeyen SenderInfo: Bu durumda, belgeyi gönderen kişi e-posta parametresinin belirttiği kullanıcıdır. Parola değeri boş (null) olmalıdır. EchoSign, API çağırıcısı ve hedeflenen gönderenin aynı kişi olduğunu doğrular, fakat parola istemez veya parolayı kontrol etmez. Bu yöntem, kimi zaman belirli bir kuruluş içindeki API entegrasyonları için uygundur, fakat bireysel güvenlik düzeyi düşüktür. Bu kimlik doğrulama yönteminin EchoSign API ile kullanılabilmesi için yöntemin ana hesap sahibi tarafından özel olarak talep edilmesi gereklidir.
Yukarıda da belirtildiği gibi, çoğu durumda adına belge gönderdiğiniz kullanıcının e-posta adresi ve parolasını istersiniz. Aşağıdaki bölümde, bu bilgilerin alınabileceği farklı yollar açıklanmaktadır.
Gönderme prosedürünün bir parçası olarak, kullanıcıdan eSign services e-postası ve parolasını isteyebilirsiniz. Kullanıcının eSign services kaydı olup olmadığını ve parolanın geçerliliğini kontrol etmek için verifyUser (Kullanıcıyı Doğrula) yöntemini kullanabilirsiniz. Kullanıcı kayıtlı değilse eSign services hesabını oluşturmasını isteyebilir veya kullanıcı adına siz bir hesap oluşturabilirsiniz (aşağıdaki bölüme bakın).
verifyUser çağrısı, bu e-posta adresine sahip bir kullanıcı olmadığını gösteriyorsa createUser yöntemini çağırarak bir eSign services kullanıcısı oluşturabilirsiniz. Kullanıcı oluşturma işleminin başarılı olduğunu varsayarsak verdiğiniz e-posta ve parola belgenizin SenderInfo değeri olarak kullanılabilir.
Yukarıda belirtilen durumların ardından kullanıcının e-posta adresi ve parolasını hatırlayabilir ve daha sonra kullanıcı adına belge gönderirken bu bilgileri SenderInfo parametresi olarak kullanabilirsiniz. Kullanıcının dilediği zaman eSign services hesabında oturum açarak parolasını değiştirmesi mümkündür; bu nedenle uygulamanızın daha önce kaydedilen parolanın geçersiz kalma durumu için hazırlıklı olması gerekir.
eSign services Document API'nin kullanırken gönderenin kimliğini belirlemenin çeşitli yolları vardır. Uygulamanıza en uygun yöntemi seçmek için yukarıdaki bilgileri dikkatle okuyun. Sorularınız için lütfen bize ulaşın.