Question

我正在使用DocuSign REST API使用/ envelopes / {envelopeID} / views / recipient调用为预定义的文档模板创建嵌入式签名。我知道在创建信封时可以预先填充标记值，但是可以在签名完成后检索接收者在给定标记字段中实际提供的值以便在应用程序中使用吗？如果是这样，有没有人有例子？

Answer 1

听起来您正尝试使用可选查询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"
          }

Answer 2

是的，至少有几种方法可以从签名（已完成）的文档中检索选项卡值。我相信贾斯汀的答案是单向的。您还可以使用获取标签信息进行收件人 API调用，该调用将返回标签信息（包含值）：

URL：

/帐户/ {帐户ID} /信封/ {envelopeId} /接收者/ {recipientId} /翼片

方法：

GET

来自DocuSign API Docs的示例：

    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":[{
        ...
     }]
    }

是否可以从签名的DocuSign文档中检索输入的标记值

2 个答案: