Docusignapi REST-将收件人添加到信封角色

我正在尝试将收件人添加到从模板创建的信封草稿中，该模板用于角色（“AlliancesDirectoy”和“Partner”）。为了清晰起见，这两个角色都是按顺序1排列的，但这并不重要

创建信封后，我们可以看到信封草稿已使用两个定义的角色创建

现在我尝试将收件人添加到我的角色“AlliancesDirector”

{
    "signers": [
    {
      "email": "mike@xyz.com",
      "Name": "Mike",
      "RecipientId": 1,
      "RoleName": "AlliancesDirector",
    }
  ]
}

这将导致以下响应：

如果我查看已添加到信封id的收件人，请参见以下内容：

当然，这让我相信，当我尝试使用已在使用的recipientId“1”添加收件人时，它是不喜欢的。例如，如果我将recipientId更改为5，它会在角色之外添加我的收件人。我不想添加角色之外的内容，我想将用户放入预定义的角色中

---

希望这篇更详细的解释能对我的工作有所帮助。

这将是在创建信封时向模板中添加收件人

{
    "emailSubject": "StackOverflow Test",
    "status": "created",
    "templateId": "63611019-753f-41c2-b9fe-6aab8ea26387",
    "templateRoles": [
        {
            "email": "so@emaildomain.com",
            "name": "Stack Overflow",
            "roleName": "Leet Person"
        }
    ]
}

---

这将是向现有信封中添加收件人（无论是否为模板）：

如往常一样，请参阅文档以获取电话的具体指导

修改或更正并重新发送收件人信息 这使您可以修改草稿信封中的收件人，或更正处理中信封的收件人信息

{
    "emailSubject": "StackOverflow Test",
    "status": "created",
    "templateId": "63611019-753f-41c2-b9fe-6aab8ea26387",
    "templateRoles": [
        {
            "email": "so@emaildomain.com",
            "name": "Stack Overflow",
            "roleName": "Leet Person"
        }
    ]
}

对于草稿信封，您可以编辑：电子邮件、用户名、发送顺序、传真号码、投递方式、， accessCode和RequiredLookup

---

注意：如果您发送的收件人信息尚未存在于草稿信封中，则 收件人将被添加到信封中（类似于邮件）

---

信封发送后，您只能编辑：电子邮件、用户名、签名名、路由订单、， 传真号码和送货方式。您还可以选择使用重新发送信封 重新发送信封选项

网址：

/accounts/{accountId}/envelopes/{envelopeId}/recipients

---

可选添加：

重新发送信封

{true或false}

我花了一些时间来破解这个问题，但最终能够重现您的错误，我相信我知道您做错了什么。根据我对您正在进行的第二次API调用的详细信息提出的问题，您需要执行以下操作：将收件人分配给给定的模板角色，我遇到的错误与错误使用

POST

方法时的错误相同，并且认为您也在这样做

---

将您的第二个电话从

POST

更改为

PUT

，它应该可以工作。我已经在测试中验证了这一点，这与预期相符。

谢谢，但我发现第二个json字符串存在两个问题。1.RecipientId已由模板最初指定的角色使用。在您的情况下，RecipientId“1”将无效，因为它正在使用中。2.如果我将recipientId增加到10（一个不是角色使用的数字），那么在本例中，除了角色之外，它还会添加新的“签名者”。这不是你发现的吗？你必须从你试图更新的角色中找到recipientId并使用它。我的示例是一个非常简单的示例，因为您只提供了一个简单的问题：）在

“RoleName”：“AlliancesDirector”，

中，您似乎没有用额外的逗号传递有效的JSON。你也没有用普通的cammelCase。。。它应该是

roleName

，

recipientId

，等等。对于这两个调用中的每一个调用，您使用的URL和方法是什么？首先，当您从模板创建信封时，您还应该包括您正在使用的请求正文。我越想这一点，问题一定是如何从模板创建信封。您是否将收件人分配给此时的角色？你的JSON在那个调用中是什么样子的？就是这样。我没有想到要执行PUT，但考虑到现有的recipientId需要更新，现在确实有意义了。自从你们搬走了论坛的位置后，我就没怎么去过了，但还是一如既往地做得很好。另外一个快速问题：假设只有一个用户可以占用模板角色是安全的，还是有办法将多个用户添加到一个角色中？