如何获取创建的信封的准备重定向URL?

时间:2017-12-14 13:45:12

标签: docusignapi

我正在使用服务帐户代表其他用户发送信封。使用API​​,我然后在“已创建”状态下创建一个信封,用于手动选项卡放置。一旦我从DocuSign API返回#section-campaign { display: flex; flex-direction: column; justify-content: space-around; z-index: -5; width: 100%; } .campaign-thumbnails { display: -webkit-box; display: -ms-flexbox; display: flex; -webkit-box-orient: horizontal; -webkit-box-direction: normal; -ms-flex-direction: row; flex-direction: row; width: 100%; -ms-flex-pack: distribute; justify-content: space-around; } .campaign-thumbnails img { -webkit-box-flex: 1; -ms-flex: 1 1 auto; flex: 1 1 auto; } <section id="section-campaign"> <div class="campaign-title"> <h3>Choose campaign</h3> </div> <div class="campaign-thumbnails"> <img id="campaign-img-q" onmouseout="qFilterOn()" onmouseover="qNoFilter()" onclick="qFilter()" class="thumbnail-campaign grey-campaign-img" src="images/city.jpeg" alt="campaign 1"> <img id="campaign-img" onmouseout="filterOn()" onmouseover="noFilter()" onclick="xFilter()" class="thumbnail-campaign grey-campaign-img" src="images/resort.jpeg" alt="campaign 2"> <img id="campaign-img-z" onmouseout="zFilterOn()" onmouseover="zNoFilter()" onclick="zFilter()" class="thumbnail-campaign grey-campaign-img" src="images/culture.jpeg" alt="campaign 3"> </div> </section> ,我想创建一个我将发送回发送给“代表发送”用户的URL,以便他/她可以轻松地开始放置标签。 / p>

我已尝试使用EnvelopeSummary / CreateSenderView方法,但我不知道“代表发送”用户的CreateConsoleView / AccountId我也不想使用他们的信息。相反,我想将用户重定向到可以登录的DocuSign,然后在登录后重定向到信封。

我还考虑从Password

创建自己的网址
envelopeId

如果用户已登录,则会将用户重定向到信封,如果没有,系统会提示他们登录然后重定向。这是我正在寻找的功能,但是,如果可能的话,我想使用API​​生成此URL,因为我不确定引用的URL是否会随着时间的推移保持静态。

有什么想法吗?

2 个答案:

答案 0 :(得分:0)

如果您还没有这样做,我建议您查看{{3>} 代表发送(SOBO)功能。正如文档所述:

  • 只有当两个用户都是相同的DocuSign帐户的成员时,才能使用SOBO功能。
  • 您(您的应用程序/用户界面)必须至少从代表您发送的用户那里收集用户名和密码 - 因为您需要输入用户名和密码获取一个访问令牌,该令牌随后可用于代表他们提交API请求。由于令牌不会过期(即使/当SOBO用户更改密码时也是有效的),您只需要从SOBO用户那里收集一次用户名/密码,然后使用这些凭证生成一个可以无限期使用的访问令牌代表他们发送。

我不建议使用envelopeId来创建自己的网址,因为DocuSign不支持此功能 - 即使它今天有效,也不能保证它会继续在未来的日子里工作。

最后,发出DocuSign API documentation请求(使用SOBO)将返回一个URL,该URL可用于启动指定Envelope的发件人(标记)视图。但请注意,URL会在短时间(5分钟后)后过期 - 这意味着您不应发出创建发件人视图请求以检索用户之前的URL( sender)已准备好标记/发送信封。例如,发出生成URL然后通过电子邮件将该URL发送给发件人的请求是不可行的 - 因为不保证用户(发件人)会打开电子邮件并单击链接以启动发件人链接过期前查看。相反,您应该向发件人提供一种方式,以便在他们准备好标记/发送信封时向您的应用程序指示,然后在那时发出创建发件人查看请求并重定向用户(发件人) )收到URL后立即到该URL。

更新(Legacy SOBO)

@EnterTheCode - 感谢您在评论中提供的说明。您对 Legacy SOBO 功能的理解是正确的;也就是说,它不要求您获得SOBO的访问令牌,也不要求您获得SOBO用户的密码。您只需添加X-DocuSign-Authentication请求标头即可指定您的&#34;服务帐户&#34;的用户名和密码,集成商密钥以及您所用的用户的电子邮件地址(或用户ID)。 ;代表发布API请求。

(旁注:虽然 Legacy SOBO 显然仍然受支持,但它是Create Sender View用于服务集成。相反,DocuSign现在推荐no longer recommended。)

不过把SOBO身份验证技术放在一边,我的原始答案的其余部分仍然适用于您的场景。也就是说,要检索可用于启动指定信封的发件人(标记)视图的URL,您需要使用创建发件人视图操作。而且,如前所述,该操作返回的URL将在很短的时间后过期 - 因此请务必考虑设计实现的方式。

答案 1 :(得分:0)

为什么要使用SOBO,如果您希望有人更新信封,那么您可以将该用户作为第一个收件人添加到信封中,其中recipienttype为“Allow To Edit”(API中的“editors”术语)。当收件人输入“Allow to Edit”时,DocuSign将向收件人发送一封电子邮件,然后收件人必须登录他的DocuSign帐户,之后该用户将能够访问该信封,并可以像编辑信封一样使用DS标签标记文档,添加,删除收件人等,与“发件人视图”相同。通过这种方式,您无需为嵌入式发送视图创建网页。