2014-07-22 33 views
3

我正在使用DocuSign REST API爲使用/ envelopes/{envelopeID}/views/recipient調用的預定義文檔模板創建嵌入式簽名。我知道可以在創建信封時預先填充標記值,但是可以在簽名完成後檢索收件人在給定標記字段中實際提供的值以便在應用程序中使用該值嗎?如果是這樣,有沒有人有一個例子?是否可以從已簽名的DocuSign文檔中檢索已輸入的標籤值

+2

我不要求爲工具的建議。我試圖找出如何使用DocuSign API從簽名文檔中檢索信息。 – breakoutbox

+3

似乎是一個合法的問題..奧普想知道如何通過DocuSign API獲取特定的信息,而不是使用外部工具。我想你只是誤讀了 – ladieu

回答

5

聽起來像是你試圖讓信封收件人的狀態,並且可選查詢include_tabs

https://www.docusign.com/sites/default/files/REST_API_Guide_v2.pdf第133頁

示例請求

GET https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId 
    }/recipients/?include_tabs=true 

X-DocuSign-Authentication: 
<DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><Integrato 
rKey>{integrator_key}</IntegratorKey></DocuSignCredentials> 
Accept: application/json 
Content-Type: application/json 

響應

響應返回收件人類型和當前路由順序。收件人類型包括收件人姓名,電子郵件地址,ID,收件人類型,路由順序,身份驗證狀態(包括日期/時間 以及身份驗證結果)狀態(包括狀態更改的日期/時間),以及 收件人狀態被拒絕並且需要原因,收件人添加了拒絕原因。如果 可選查詢include_tabs設置爲true,則返回與收件人關聯的 選項卡。

下面的示例示出了響應JSON體

實施例響應

{ 
    "signers": [ 
    { 
     "tabs": { 
     "textTabs": [ 
      { 
      "height": 11, 
      "name": "Text", 
      "value": "this is a test", 
      "width": 66, 
      "required": "false", 
      "locked": "false", 
      "disableAutoSize": "false", 
      "tabLabel": "TAB1", 
      "documentId": "1", 
      "recipientId": "ed0e8744-6243-4708-9186-0e3ccf4cb3a4", 
      "pageNumber": "1", 
      "xPosition": "93", 
      "yPosition": "142", 
      "tabId": "2c7b4d94-d958-44df-b5a7-2b530ce914ed" 
      } 
+0

這正是我所期待的。我相信這個混淆與UI和API之間這些字段的名稱不一致。在用戶界面中,他們被稱爲「標籤」無處不在,但在API中它們看起來被稱爲「標籤」 – breakoutbox

1

是有至少一對的方式來從所述簽名(已完成)的文檔檢索標籤值。我相信賈斯汀的回答是一種方式。您也可以使用獲取標籤信息的收件人 API調用,這將返回標籤的信息(包括值):

網址:

  • /帳號/ {帳戶ID} /袋/ {envelopeId} /接收者/ {recipientId} /選項卡

方法:

例子:

GET https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs 

    X-DocuSign-Authentication: <DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials> 
    Accept: application/json 
    Content-Type: application/json 

樣品響應:

{ 
     "approveTabs":[{ 
     <Tab information removed> 
     }], 
     "textTabs":[{ 
     <Tab information removed> 
     }], 
     "signHereTabs":[{ 
     ... 
    }] 
    } 
+0

如果您正在查找特定收件人的信息,這也是一個很好的答案。不過,在我的具體情況中,我使用的是嵌入式簽名,我從不設置收件人ID。這裏有很好的信息給別人。 – breakoutbox

相關問題