使用 Acrobat Sign API 指定发送者身份

上次更新日期： 2022年4月6日

概述

设计 Adobe Acrobat Sign 文档 API 的目的在于，您无需另外执行由 Acrobat Sign 管理的注册流程，即可与现有应用程序无缝集成。为此，该内含应用程序将负责确保发件人是经过注册的 Acrobat Sign 用户。如果发送者未经注册，则可以通过该 API 采用编程方式进行注册。对于收件人，系统从不要求他们必须注册，因为无论收件人是否有必要交互，Acrobat Sign 始终都会进行管理。

指定一个文档发送者

使用 sendDocument 方法启动一项新事务时，指定发送者的方式可以有多种。具体的行为取决于通过可选的 SenderInfo 参数传递了哪些值。

SenderInfo 参数值为 Null：对于这种情况，文档的发送者是与将要使用的 API 密钥关联的特定且唯一的用户。这种方法适用于测试和实施具体的限定范围，但是通常并不适用于大规模集成现有的用户组。

SenderInfo 参数的值包含 email 和 password：对于这种情况，文档的发送者是 email 参数指定的用户。提供的密码必须与该用户的 Acrobat Sign 密码相同。出于集成的目的，可以在要发送文档时，在内含应用程序的环境下征求该用户的电子邮件地址和密码。或者，内含应用程序可以记住电子邮件地址和密码，因为是该内含应用程序创建了该用户，或者是由于该用户此前已经提供了这项信息并且系统已进行了缓存。

SenderInfo 参数的值包含 email，且没有 password：对于这种情况，文档的发送者是 email 参数指定的用户。 password 的值必须为 null。 Acrobat Sign 会验证 API 调用方与预期的发件人是否属于同一帐户，但是并不要求提供或检查密码。有时，这种方法适用于某一特定组织内的 API 集成，但是个人的安全性会因此而有所降低。 这种身份验证模式必须由主帐户持有人发起显式请求，方可通过 Acrobat Sign API 进行使用。

Acrobat Sign 帐户管理

正如上文所述，大多数情况下，您希望提供发送文档的委托用户的电子邮件地址和密码。下面的内容概述了获取该信息的各种方法。

提示用户

提示用户输入其 Acrobat Sign 电子邮件地址和密码，以此作为发送流程的一部分。可使用 verifyUser 方法来检查用户是否注册了 Acrobat Sign 以及密码是否有效。如果用户尚未注册，您既可以要求他们创建自己的 Acrobat Sign 帐户，也可以为他们创建一个帐户（请参见下方内容）。

创建帐户

如果调用 verifyUser 方法后系统显示不存在任何具有该电子邮件地址的用户，您可以采用编程方式通过调用 createUser 方法来创建一个 Acrobat Sign 用户。假设成功创建了用户，那么您提供的电子邮件地址和密码现在就可以用作文档的 SenderInfo 内容。

记住帐户

在执行了上面所提供的任一方案后，接下来，您可以记住用户的电子邮件地址和密码，并代表该用户将这些信息用作发送后续文档的 SenderInfo。实际上，该用户可能会随时登录到其 Acrobat Sign 帐户并更改密码，因此您的应用程序必须能够处理“此前保存的密码无效”的情况。

总结

使用 Acrobat Sign 文档 API 时，有多种不同的方法可确定发件人的身份。请仔细阅读上面的信息，确定适合您应用程序的具体方法。如果您有任何问题，请随时联系我们。

使用 Acrobat Sign 简化您的工作
快速轻松地在线管理和签署文档。

打开该应用程序

配置无 Cookie 嵌入式发送

学习

通过应用程序中的分步视频教程和实践指导进行学习。

社区

加入讨论、寻找答案、向专家学习并分享您的知识。

Adobe 主页

访问您喜爱的 Creative Cloud 应用程序、服务、文件管理等。