使用Node.js的docusign-esign库重发信封遇请求错误的解决方法

你之前用updateRecipients方法带resendEnvelope: true报错，是因为用错了API接口——updateRecipients的核心作用是修改收件人信息，resendEnvelope参数仅在修改收件人后配合触发重发，单独用它来重发信封不符合接口设计，所以会返回Bad Request。

正确的做法是使用envelopesApi.resendEnvelope方法，这是DocuSign专门用于重发现有信封的接口。

代码示例 #

重发给所有未完成流程的收件人 #

如果不需要指定特定收件人，直接重发给所有当前需要操作的收件人，代码如下：

return await envelopesApi.resendEnvelope(
  docusign_api_account_id,
  envelopeId,
  {} // 空对象表示重发给所有符合条件的收件人
);

重发给指定收件人 #

如果只想重发给某个特定收件人，需要在请求体中指定该收件人的信息（需匹配信封中原有的收件人ID、邮箱或姓名）：

return await envelopesApi.resendEnvelope(
  docusign_api_account_id,
  envelopeId,
  {
    recipients: {
      signers: [
        {
          email: "recipient@example.com",
          name: "Recipient Full Name",
          recipientId: "1" // 对应信封中该收件人的ID
        }
      ]
    }
  }
);

注意事项 #

• 仅能重发状态为已发送（sent）且未完成的信封，已完成或已作废的信封无法重发。
• 确保你的API账号拥有足够的权限（需包含发送信封的权限）。

内容的提问来源于stack exchange，提问作者edencorbin