Genel Bakış
Adobe Acrobat Sign Belge API, Acrobat Sign 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 Acrobat Sign 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 Acrobat Sign yönetir.
Belgeyi gönderen kişiyi belirtme
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 Acrobat Sign 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. Acrobat Sign, API çağırıcısı ve hedeflenen gönderenin aynı hesabın sahibi 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 Acrobat Sign API ile kullanılabilmesi için yöntemin ana hesap sahibi tarafından özel olarak talep edilmesi gereklidir.
Acrobat Sign hesap yönetimi
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.
Kullanıcıdan isteme
Gönderme prosedürünün bir parçası olarak, kullanıcıdan Acrobat Sign e-postası ve parolasını isteyebilirsiniz. Kullanıcının Acrobat Sign 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 Acrobat Sign hesabını oluşturmasını isteyebilir veya kullanıcı adına siz bir hesap oluşturabilirsiniz (aşağıdaki bölüme bakın).
Hesap oluşturma
verifyUser çağrısı, bu e-posta adresine sahip bir kullanıcı olmadığını gösteriyorsa createUser yöntemini çağırarak bir Acrobat Sign 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.
Hesabı hatırlama
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 Acrobat Sign 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.
Sonuç
Acrobat Sign Belge API 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.
