概述
设计 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 时,有多种不同的方法可确定发件人的身份。 请仔细阅读上面的信息,确定适合您应用程序的具体方法。 如果您有任何问题,请随时联系我们。