Question

我在使用以下网址失败的REST API尝试delete a tab时遇到问题：

https://demo.docusign.net/restapi/2/accounts/ {帐户ID} /信封/ {envelopeID} /接收者/ 1 /翼片

使用正文{"checkboxTabs":[{"tabId":"168229c3-d717-436f-b6a9-5f014d1817bb"}]}删除：

{
  "checkboxTabs": [
    {
      "selected": "false",
      "requireInitialOnSharedChange": "false",
      "recipientId": "1",
      "tabId": "168229c3-d717-436f-b6a9-5f014d1817bb",
      "errorDetails": {
        "errorCode": "INVALID_TAB_OPERATION",
        "message": "The Tab specified is not valid for the requested operation."
      }
    }
  ]
}

目前还不清楚问题是什么，我找不到正确用法的好例子。是否有可能未找到要删除的标签？

更新

我还尝试了UPDATE而不是DELETE，我得到了以下响应体（有趣的是响应显示textTabs而不是checkboxTabs）：

{
  "textTabs": [
    {
      "requireAll": "false",
      "concealValueOnDocument": "false",
      "disableAutoSize": "false",
      "documentId": "1",
      "recipientId": "1",
      "tabId": "00000000-0000-0000-0000-000000000000",
      "errorDetails": {
        "errorCode": "INVALID_TAB_OPERATION",
        "message": "The Tab specified is not valid for the requested operation.  The Tab specified is not valid for the requested operation. Recipient not in state that allows correction."
      }
    }
  ]
}

但是这次错误信息还包含“收件人不在允许更正的状态”，这意味着我正在尝试无效操作，因为收件人已经签名？如果有人能澄清这有助于我的理解。

如果DELETE方法也包含类似的消息，那将非常有用。

Answer 1

如果tabID不存在，则应出现该错误。我建议您通过对同一网址执行GET来仔细检查tabID。

Answer 2

如果您指定的任何标签属性不正确，我相信您会收到该错误。例如，您可能指的是正确的tabId，但如果相关标签位于文档2（例如）上，并且您在请求中引用documentId = 1，则会收到该错误。

我建议您在发送DELETE请求之前先在选项卡上执行GET，然后检查返回的所有属性，并验证它们是否与您在删除时发送的内容相匹配请求。

<强>更新

我刚刚意识到你可能遇到了什么。您尝试制作的EnvelopeTabs: delete API请求说明了

“删除与草稿信封中的收件人关联的一个或多个标签。”

我相信这只适用于DRAFT信封。一旦你发送了信封，你需要做一个信封修正，如果你想改变它的方方面面。您的错误消息也引用了此

“收件人不在允许更正的状态”

删除信封中的标签时出错

2 个答案: