Přehled
Rozhraní API pro dokumenty služby Adobe Acrobat Sign slouží k bezproblémové integraci do vaší stávající aplikace, aniž byste museli procházet samostatným procesem registrace řízeným službou Acrobat Sign. Vlastní aplikace tak zodpovídá za to, aby byl odesílatel registrovaným uživatelem služby Acrobat Sign. Pokud jím není, zaregistruje jej programově prostřednictvím API. Příjemci se nikdy registrovat nemusí a služba Acrobat Sign vždy řídí, zda jsou interakce na straně příjemce nezbytné.
Určení odesílatele dokumentu
Při zahájení nové transakce pomocí metody sendDocument lze odesílatele určit několika způsoby. Chování závisí na tom, jaké hodnoty jsou dodávány prostřednictvím volitelné metody SenderInfo.
- Prázdná hodnota SenderInfo: V tomto případě je odesílatelem dokumentu konkrétní jedinečný uživatel spojený s použitým klíčem API. Tato metoda je vhodná pro testování a určité implementace s omezeným rozsahem, ale obvykle se nehodí pro rozsáhlé integrace se stávajícími sadami uživatelů.
- SenderInfo s e-mailem a heslem: V tomto případě je odesílatelem dokumentu uživatel specifikovaný parametrem e-mail. Zadané heslo se musí shodovat s heslem uživatele pro službu Acrobat Sign. Pro účely integrace lze e-mail a heslo v kontextu vlastní aplikace od uživatele vyžádat před odesláním dokumentu. Případně si vlastní aplikace může e-mail a heslo pamatovat, protože uživatele vytvořila nebo protože uživatel tyto údaje dříve zadal a údaje byly uloženy do mezipaměti.
- SenderInfo s e-mailem a bez hesla: V tomto případě je odesílatelem dokumentu uživatel specifikovaný parametrem e-mail. Hodnota hesla musí být nulová. Služba Acrobat Sign ověřuje, zda uživatel volající rozhraní API a zamýšlený odesílatel patří ke stejnému účtu, ale nevyžaduje ani nekontroluje heslo. Tato metoda je někdy vhodná pro integrace API v konkrétní organizaci, ale omezuje omezené individuální zabezpečení. Tento model ověřování musí být výslovně požadován držitelem hlavního účtu, aby byl k dispozici k používání prostřednictvím rozhraní API služby Acrobat Sign.
Správa účtu služby Acrobat Sign
Jak je popsáno výše, ve většině případů chcete zadat e-mail a heslo uživatele, jehož jménem dokument odesíláte. V následující sekci jsou popsány různé způsoby, jak lze tyto údaje získat.
Požádání uživatele
Požádejte uživatele o jeho e-mail a heslo ke službě Acrobat Sign v rámci procesu odesílání. Pomocí metody verifyUser můžete zkontrolovat, zda je uživatel zaregistrovaný ve službě Acrobat Sign a heslo je platné. Pokud uživatel zaregistrovaný není, můžete jej požádat o vytvoření vlastního účtu ve službě Acrobat Sign nebo mu účet vytvořit (viz níže).
Vytvoření účtu
Pokud volání metody verifyUser ukáže, že žádný uživatel s takovou e-mailovou adresou neexistuje, můžete uživatele služby Acrobat Sign programově vytvořit voláním metody createUser. V případě úspěšného vytvoření uživatele lze zadaný e-mail a heslo použít jako hodnoty SenderInfo pro dokument.
Zapamatování účtu
V návaznosti na oba scénáře výše si můžete uživatelův e-mail a heslo zapamatovat a používat je jako hodnoty SenderInfo pro odesílání následujících dokumentů jménem daného uživatele. Je možné, že se uživatel ve skutečnosti přihlásí ke svému účtu ve službě Acrobat Sign a heslo si kdykoli změní, proto vaše aplikace musí zvládat případy, kdy je dříve uložené heslo neplatné.
Závěr
Existuje řada různých způsobů, jak zjistit identitu odesílatele při používání rozhraní API pro dokumenty služby Acrobat Sign. Pečlivě si přečtěte výše uvedené informace, abyste zjistili, která metoda je vhodná pro vaši aplikaci. V případě dotazů nás neváhejte kontaktovat.
