关于DocuSign API指定发送信封所属组及多账户配置的技术问询

1. 信封中指定组的实现方式 #

• 你可以在创建信封的API请求里，通过recipients对象的组相关参数指定目标组。添加收件人时，将recipientType设为group，同时传入该组的groupId（组的唯一标识）即可。示例请求片段：

"recipients": {
  "signers": [
    {
      "recipientType": "group",
      "groupId": "TARGET_GROUP_ID",
      "name": "目标审批组",
      "email": "group_contact@example.com",
      "routingOrder": "1"
    }
  ]
}

• 对于关联多个组的用户，只需明确传入对应组的groupId，API会自动匹配该组的成员处理信封。注意：调用API的账户必须拥有该组的访问权限，否则会返回权限错误。
• 若需获取可用组的groupId，可调用GET /accounts/{accountId}/groups接口，返回结果包含所有组的ID、名称等详细信息。

2. 多账户配置方案 #

• 子账户模式：如果需要不同的品牌、组权限、签名流程等差异化设置，可在主账户下创建子账户。每个子账户可独立配置品牌、组、用户，API调用时通过指定子账户的OAuth令牌或accountId来区分使用。
• 账户切换机制：在API请求中，通过URL路径（如/accounts/{target_account_id}/envelopes）或请求头携带目标账户ID，即可切换到对应账户发送信封，前提是主账户拥有该子账户的访问权限。
• 权限隔离：子账户的配置相互独立，不会交叉影响，适合不同业务线或部门的个性化需求。建议为每个子账户单独生成OAuth凭据，便于权限管控和审计。

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