docusignapi - 将多个电子邮件地址传递给 templateRoles 中的单个数组

Question

是否可以将逗号分隔的电子邮件地址列表传递给 templateRoles 中的电子邮件元素，即“email”=> $to，其中 $to 是逗号分隔的电子邮件列表？还是每个收件人都必须在自己的数组中单独指定？

Answer 1

每个收件人都必须在他们自己的数组中指定。DocuSign 平台通过姓名、电子邮件、收件人ID 的组合来识别收件人（如果使用嵌入功能，还包括clientUserId）。因此，您不能只拥有一个来自给定收件人的电子邮件属性的逗号分隔列表。

例如，使用 JSON 格式的请求正文，您的收件人通常应该如下所示：

"recipients": {
    "signers": [
        {
            "email": "firstemail@gmail.com",
            "name": "First Recipient",
            "recipientId": "1",
            "routingOrder": "1",
            "tabs": {
                "signHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "100",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ]
            }
        },
        {
            "email": "secondemail@gmail.com",
            "name": "Second Recipient",
            "recipientId": "2",
            "routingOrder": "2",
            "tabs": {
                "initialHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "200",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ],
                "signHereTabs": [
                    {
                        "xPosition": "200",
                        "yPosition": "200",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ]
            }
        }
    ],
    "carbonCopies": [
        {
            "email": "thirdemail@gmail.com",
            "name": "Third Recipient",
            "recipientId": "3",
            "routingOrder": "3"
        },
        {
            "email": "forthemail@gmail.com",
            "name": "Forth Email",
            "recipientId": "4",
            "routingOrder": "3"
        }
    ]
}

上面的 JSON 将向给定的信封添加 4 个收件人 - 2 个签名收件人（一个带有 1 个 signHere 选项卡，另一个带有一个 signHere 选项卡和一个 initialHere 选项卡）和 2 个抄送 (CC) 收件人。