Docusignapi DocuSign API-重置/解锁RecipientAuthenticationStatus

我正在使用DocuSign API在我的应用程序中对文档进行电子签名。我正在使用访问码身份验证功能，以获得一些额外的安全性；但是，我正在尝试（通过API）对多次输入错误访问代码的签名者进行“解锁”，而不会作废和创建新信封，也不会使用DocuSign管理界面

我不在乎是否需要重新发送最初的电子邮件，我只想保留我客户的信封总数。同样重要的是（如果有多个签名者），如果一个签名者在签名者2的身份验证错误之前完成了签名，我不会强制一个签名者必须多次签名

我尝试了一篇帖子：

 /v2/accounts/{accountId}/envelopes/{envelopeId}?resend_envelope=true

我还使用docusign java客户端寻找了一个解决方案：

Recipients recipients = envelopesApi.listRecipients(accountId, envelopeId);
List<Signer> signers = recipients.getSigners(); 

for (Signer signer : signers) {
    signer.setRecipientAuthenticationStatus(null);  
}

我可以通过DocuSign管理GUI“重新发送”，一切都按预期进行

---

有没有办法通过API以编程方式“重置/解锁”此身份验证功能

我认为您需要删除然后重新添加收件人（签名者）。这使得签名者成为新的接收者

但是，这样做意味着您需要重新创建有关签名者的所有信息：他们的文档选项卡/字段等

我无法想象简单地作废/重新发送信封比花开发人员的时间处理这个问题要便宜

---

如果这种情况经常发生，那么也许可以考虑为您的签名者提供有关使用访问代码功能的更好培训。

您可以使用下面的

PUT

endpoint

PUT /restapi/v2/accounts/<accountId>/envelopes/<envelopeId>?resend_envelope=true

---

这将向身份验证失败的签名者发送另一封电子邮件，该用户将再次获得输入访问代码的选项。

根据找到的文档

我必须在请求中包含json或xml（如果身份验证方法失败）。我错误地认为，如果只有一个收件人，那么我就不必指定。如果只想重新发送信封，则不需要包含和签名者数据

例如：

{"signers" :
    [{"email":"testEmail@gmail.com",
      "name":"FirstName LastName",
      "recipientId":"1"
     }]
 }

然后，您应该得到如下响应：

{"recipientUpdateResults": 
   [{
      "recipientId": "1",
      "errorDetails": 
       {
         "errorCode": "SUCCESS",
         "message": ""
       }
   }]
 }

---

我感谢你的帮助。我能回答我的问题。至于“便宜”一点，我完全同意；然而，作为一名开发人员，我没有做出这个决定的自由。我只是想找到一种我认为最有效的方法，即使这意味着在很长一段时间内花一美元来节省一分钱。再次感谢你的帮助。很乐意帮忙。感谢您使用DocuSign。

{"signers" :
    [{"email":"testEmail@gmail.com",
      "name":"FirstName LastName",
      "recipientId":"1"
     }]
 }

{"recipientUpdateResults": 
   [{
      "recipientId": "1",
      "errorDetails": 
       {
         "errorCode": "SUCCESS",
         "message": ""
       }
   }]
 }