带模板的嵌入式批量发送

创建 BulkSendJob，根据要在嵌入式 iFrame 中签名的 `template_ids` 参数指定的提供模板批量发送最多 250 个 SignatureRequest。这些嵌入式签名请求只能在嵌入式 iFrame 中签名，而普通签名请求只能在 Dropbox Sign 上签名。 **注意：** 仅适用于标准计划及更高版本。

通过完整的 Dropbox Sign v3 API 管理账户、签名请求、模板、团队、批量发送、文件下载、传真和事件回调；Hub 仅提供文档与本地 SDK/CLI。

请求

operationId: signatureRequestBulkCreateEmbeddedWithTemplate
服务器: https://api.hellosign.com/v3
认证: api_key, oauth2

请求参数

无 URL、查询或 Header 参数。

Body 参数

SignatureRequestBulkCreateEmbeddedWithTemplateRequest必填

Content-Type: application/json, multipart/form-data

字段: template_idssigner_filesigner_listallow_declineccsclient_idcustom_fieldsmessagemetadatasigning_redirect_urlsubjecttest_modetitle

{
  "template_ids": [
    {}
  ],
  "signer_list": [
    {
      "custom_fields": [
        {
          "name": "Example Name"
        }
      ],
      "signers": [
        {
          "name": "Example Name",
          "email_address": "developer@example.com",
          "sms_phone_number": "+12025550123",
          "sms_phone_number_type": "authentication"
        }
      ]
    }
  ],
  "allow_decline": false,
  "ccs": [
    {
      "email_address": "developer@example.com"
    }
  ],
  "client_id": "example-client-id",
  "custom_fields": [
    {
      "name": "Example Name",
      "required": false
    }
  ],
  "message": "Example message"
}

响应

`200`

BulkSendJobSendResponseapplication/json

成功响应

字段: bulk_send_jobwarnings

`4XX`

ErrorResponseapplication/json

操作失败

字段: error

{
  "bulk_send_job": {
    "bulk_send_job_id": "example-bulk-send-job-id",
    "total": 0,
    "is_creator": false,
    "created_at": 0
  },
  "warnings": [
    {
      "warning_name": "Example Name"
    }
  ]
}