Docusign 更新收件人

Question

我们的应用程序使用具有 2 个角色的 API 从模板创建草稿信封。

角色名称：“signer1” "recipientId":"1", “角色名称”：“签名者1”， "routingOrder":"1", “电子邮件”：“电子邮件 1”， “名称”：“名称1”

角色名称：“signer2” "recipientId":"2", "角色名":"signer2", "routingOrder":"2", “电子邮件”：“电子邮件2”， “名称”：“名称2”

草稿正确创建，我可以按原样发送。

问题是，如果我想在发送前通过 API 更新其中一个收件人，docusign 使用哪个字段来了解您要更新的收件人？

例如我想更改签名者 1 的电子邮件地址

我希望问题足够清楚。

Answer 1

要从草稿信封修改现有收件人，您需要使用“recipeintId”来引用特定收件人，然后在 PUT 调用中输入您希望修改的详细信息。 下面您将找到一个示例，当我修改收件人 ID 1 并给他一个新的姓名和电子邮件地址时。

注意：为了简单起见，我在示例中使用 X-DocuSign-Authentication 标头，而不是为了安全措施，应该使用不记名令牌。

文档：Link to DocuSign Documentation

PUT https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients

X-DocuSign-Authentication: <DocuSignCredentials><Username>{name}</Username><Password>{password}</Password><IntegratorKey>{integrator_key}</IntegratorKey></DocuSignCredentials>
Accept: application/json
Content-Type: application/json
{
 "signers" :
 [
   {
     "email": "john.doe@comapany.com",
     "name": "John Doe",
     "recipientId": "1"
    }
 ]
}

要收集您可以使用的信封的收件人 ID。具有相似 URL 的 GET 请求

GET https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients