docusignapi - 获取信封地址

Question

有没有一种方法可以使用 API 获取 URL，以便用户查看 DocuSign 网站上的特定信封？我没有尝试使用嵌入式签名体验，因此 API 提供的各种信封“ View ”不是所需的 URL。目标是在自定义 Web 应用程序中提供一个链接，单击该链接会根据用户登录 Docusign 网站显示信封，必要时重定向到 Docusign 登录页面(“控制台”URL 提供所需的 UI，但不强制这种正常的网站身份验证)。

我看过其他几个帖子，包括 url for managing an evelope和 get document url .后者看起来很有前途(虽然在我的例子中所需的 URL 是用于整个信封，而不是特定文档)，但没有提供构建完整 URL 的代码示例。

我正在使用 C#，代码包含以下内容(基于 get envelope API ):

EnvelopesApi envelopesApi = new EnvelopesApi(loginResult.ApiConfiguration);
var envelope = envelopesApi.GetEnvelope(loginResult.AccountId, envelopeId);

string envelopeUri = envelope.EnvelopeUri;

Uri baseUri;
if (Uri.TryCreate(baseUrl, UriKind.Absolute, out baseUri))
{
    var uriBuilder = new UriBuilder(baseUri.Scheme, baseUri.Host);
    uriBuilder.Path = envelopeUri;

    envelopeUrl = uriBuilder.Uri.AbsoluteUri;
}

“baseURL”来自登录结果。生成的“envelopeUrl”的示例是 https://demo.docusign.net/envelopes/c47dfe7b-3b2c-4885-95b8-56ac7c5aba18

但是，该 URL 返回 404 错误。 URL 的路径部分是否需要更多？文档并不清楚如何使用返回的 envelopeUri，也不清楚它是供 API 使用还是用于在浏览器中使用的普通网站 URL 的一部分。

Answer 1

您提到控制台 URL 为您提供了所需的 UI，因此如果您希望控制台 URL 具有正常的网站身份验证，那么您可以使用授权码授予，https://docs.docusign.com/esign/guide/authentication/oa2_auth_code.html#starting-the-authentication-code-grant

要求用户通过 DS WebApp 进行身份验证，身份验证后，您需要使用 OAUTH API 生成他们的访问 token ，一旦您获得访问 token ，然后使用控制台 View 向用户显示 DS WebApp。