如何通过DocuSign API在指定位置为文档添加复选框？

完全可以通过DocuSign API实现这个操作，你需要在创建信封的请求中，给目标文档添加复选框标签（Checkbox Tab），具体操作如下：

• 构造创建信封的请求体，在recipients下对应收件人（如signers）的tabs字段中，添加checkboxTabs数组
• 每个复选框标签需指定关键参数：
  • documentId：目标文档的ID（上传文档时自定义的ID）
  • pageNumber：复选框所在的页码
  • xPosition、yPosition：复选框在页面上的像素坐标（可通过手动添加后调用API获取对应坐标参考）
  • tabLabel：标签标识，用于区分不同复选框
  • required：可选参数，设为true则表示该复选框为必填项

示例JSON请求片段：

{
  "emailSubject": "请签署指定文档",
  "documents": [
    {
      "documentId": "1",
      "name": "待签署文件.pdf"
    }
  ],
  "recipients": {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "签署人姓名",
        "recipientId": "1",
        "tabs": {
          "checkboxTabs": [
            {
              "documentId": "1",
              "pageNumber": "1",
              "xPosition": "150",
              "yPosition": "250",
              "tabLabel": "同意服务条款",
              "required": "true"
            }
          ]
        }
      }
    ]
  },
  "status": "sent"
}

如果不确定坐标参数，可先在DocuSign门户手动添加复选框，再调用GET /envelopes/{envelopeId}/recipients/{recipientId}/tabs接口获取已添加标签的详细信息，从中提取对应的坐标值复用即可。

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