封筒のURLを取得

Question

DocuSign Webサイトの特定の封筒を閲覧するためのURLを取得するためにAPIを使用する方法はありますか？私は埋め込まれた署名の経験を使用しようとしていないので、APIによって提供される様々なエンベロープ "ビュー"は、望ましいURLではありません。目標は、Docusign Webサイトへのユーザーのサインインに基づいてエンベロープを表示し、必要に応じてDocusignログインページにリダイレクトするカスタムWebアプリケーションのリンクを提供することです（「コンソール」URLは、この種の通常のウェブサイト認証を強制しません）。

私はurl for managing an evelopeとget document urlを含むいくつかの他の投稿を見ました。後者は有望に見えましたが（私の場合、特定の文書ではなく、包括的なエンベロープが望ましいURLですが）、完全なURLを構築するためのコード例はありません。私は（get envelope APIに基づく）以下を含むコードで、C＃を使用してい

：

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; 
} 

「ベースURLは、」ログイン結果からです。結果の「envelopeUrl」の例はhttps://demo.docusign.net/envelopes/c47dfe7b-3b2c-4885-95b8-56ac7c5aba18

ですが、そのURLは404エラーを返します。 URLのパス部分にもっと必要なものはありますか？ドキュメンテーションは、返されたenvelopeUriの使用方法やAPI用か、ブラウザで使用するための通常のウェブサイトURLの一部であるかについては明確ではありません。

Answer 1

、https://docs.docusign.com/esign/guide/authentication/oa2_auth_code.html#starting-the-authentication-code-grant

DS WebAppのを経由して、認証後に認証するようにユーザーに依頼OAUTH APIを使用してアクセストークンを生成する必要があります。アクセストークンを取得したら、Console Viewを使用してDS WebAppをユーザーに表示します。

Answer 2

はアプリが資格情報の入力をユーザーに求めると、ユーザが封筒へのアクセス権を持っている場合、エンベロープの詳細ページを表示する必要がありDocusign web app

にユーザーをリダイレクトします。

https://appdemo.docusign.com/documents/details/c47dfe7b-3b2c-4885-95b8-56ac7c5aba18 

Answer 3

受信者ビューを要求する方法はいくつかあります。コンソールビュー、送信者ビュー、または受信者ビューを取得できます。あなたの場合、署名の表示が必要なように聞こえます。 ClientUserIdを指定した場合は、リクエストで指定する必要があります。そうでない場合は、受信者の名前と電子メールをターゲットにして、https：// {endpoint} .docusign.net/restapi/v2 /アカウント/ $アカウントID /封筒/ $ envelopeId /ビュー/受信者

例：

{ "にreturnurl"： "http://localhost/returnUrl"、 "AuthenticationMethodが"： "電子メール"、 "電子メール"：「recipientemail @ 「email.com」、 「userName」：「RecipientName」

この結果、セッション中の署名li受信者がエンベロープにアクセスするために使用することができます。あなたは、通常のWebサイトの認証とのコンソールURLを望むならば、あなたは認証コードグラントを使用できるように、そのコンソールのURLは、あなたに必要なUIを提供して言及した

 EnvelopesApi envelopesApi = new EnvelopesApi(testConfig.Configuration); 
     RecipientViewRequest viewOptions = new RecipientViewRequest() 
     { 
      ReturnUrl = returnurl, 
      ClientUserId = "1234", // Must match if supplied when creating the envelope 
      AuthenticationMethod = "email", 
      UserName = "recipientName", 
      Email = "recipientEmail" 
     }; 


     ViewUrl recipientView = envelopesApi.CreateRecipientView(AccountId, EnvelopeId, viewOptions);