通过REST API从模板创建信封，能否修改签署人类型为in-person signer？

当然可以！当你通过REST API基于模板创建信封时，完全有权在请求体的templateRoles部分覆盖模板中原有的收件人配置，把普通的signer类型改成inPersonSigner类型。

具体操作要点： #

• 先确认模板中收件人2对应的roleName（这个是模板里预先定义的角色标识，必须和请求体里的roleName完全匹配，才能正确关联到该收件人）
• 在templateRoles数组里，针对这个角色，将type字段的值从signer替换为inPersonSigner
• 特别提醒：In-Person Signer需要额外配置现场主持人信息——也就是负责引导签署的人员，必须填写hostName（主持人姓名）和hostEmail（主持人邮箱）；同时也要明确填写signerName（现场签署人的姓名）

请求体示例对比 #

下面是简化后的代码片段，帮你直观看到修改前后的差异：

原请求（模板默认的Signer类型）

{
  "templateId": "your-template-id-here",
  "templateRoles": [
    {
      "roleName": "收件人1",
      "email": "recipient1@example.com",
      "name": "张三",
      "type": "signer"
    },
    {
      "roleName": "收件人2",
      "email": "recipient2@example.com",
      "name": "李四",
      "type": "signer"
    }
  ],
  "status": "sent"
}

修改为In-Person Signer后的请求体

{
  "templateId": "your-template-id-here",
  "templateRoles": [
    {
      "roleName": "收件人1",
      "email": "recipient1@example.com",
      "name": "张三",
      "type": "signer"
    },
    {
      "roleName": "收件人2",
      "type": "inPersonSigner",
      "hostName": "王二",
      "hostEmail": "wang@example.com",
      "signerName": "李四"
    }
  ],
  "status": "sent"
}

额外注意事项： #

• 不需要给In-Person Signer填写email字段，因为签署是现场完成的，系统不会给签署人发邮件，只会通知主持人
• 确保roleName和模板里的角色名完全一致，大小写、空格都要匹配，不然API会识别不到对应的模板角色
• 如果模板里已经给收件人2预设了部分信息（比如signerName），你可以选择保留或者根据实际场景更新

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