使用模板创建嵌入式无人认领草稿

使用之前保存的模板创建新草稿，可以在嵌入式 iFrame 中声明和使用该模板。第一个访问该 URL 的经过身份验证的用户将声明该草稿，并将显示加载了草稿的“请求签名”页面。后续访问声明 URL 将导致 `404`。对于此嵌入式 Endpoint，需要 `requester_email_address` 参数。 **注意：** 嵌入式无人认领草稿只能在嵌入式 iFrame 中访问，而普通草稿可以在 Dropbox Sign 上使用和访问。

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

请求

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

请求参数

无 URL、查询或 Header 参数。

Body 参数

UnclaimedDraftCreateEmbeddedWithTemplateRequest必填

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

字段: allow_declineallow_reassignccsclient_idcustom_fieldseditor_optionsfield_optionsfilesfile_urlsforce_signer_rolesforce_subject_messagehold_requestis_for_embedded_signingmessagemetadatapreview_onlyrequester_email_addressrequesting_redirect_urlshow_previewshow_progress_steppersignerssigning_optionssigning_redirect_urlskip_me_nowsubjecttemplate_idstest_modetitlepopulate_auto_fill_fieldsallow_ccs

{
  "allow_decline": false,
  "allow_reassign": false,
  "ccs": [
    {
      "email_address": "developer@example.com"
    }
  ],
  "client_id": "example-client-id",
  "custom_fields": [
    {
      "name": "Example Name",
      "required": false
    }
  ],
  "editor_options": {
    "allow_edit_signers": false,
    "allow_edit_documents": false
  },
  "field_options": {
    "date_format": "MM / DD / YYYY"
  },
  "files": [
    {}
  ]
}

响应

`200`

UnclaimedDraftCreateResponseapplication/json

成功响应

字段: unclaimed_draftwarnings

`4XX`

ErrorResponseapplication/json

操作失败

字段: error

{
  "unclaimed_draft": {
    "signature_request_id": "example-signature-request-id",
    "claim_url": "https://example.com/resource",
    "signing_redirect_url": "https://example.com/resource",
    "requesting_redirect_url": "https://example.com/resource",
    "expires_at": 0,
    "test_mode": false
  },
  "warnings": [
    {
      "warning_name": "Example Name"
    }
  ]
}