创建嵌入式无人认领草稿

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

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

请求

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

请求参数

无 URL、查询或 Header 参数。

Body 参数

UnclaimedDraftCreateEmbeddedRequest必填

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

字段: filesfile_urlsallow_ccsallow_declineallow_reassignattachmentscc_email_addressesclient_idcustom_fieldseditor_optionsfield_optionsforce_signer_pageforce_subject_messageform_field_groupsform_field_rulesform_fields_per_documenthide_text_tagshold_requestis_for_embedded_signingmessagemetadatarequester_email_addressrequesting_redirect_urlshow_previewshow_progress_steppersignerssigning_optionssigning_redirect_urlskip_me_nowsubjecttest_modetypeuse_preexisting_fieldsuse_text_tagspopulate_auto_fill_fieldsexpires_at

{
  "files": [
    {}
  ],
  "file_urls": [
    "https://example.com/resource"
  ],
  "allow_ccs": true,
  "allow_decline": false,
  "allow_reassign": false,
  "attachments": [
    {
      "name": "Example Name",
      "required": false,
      "signer_index": 0
    }
  ],
  "cc_email_addresses": [
    "developer@example.com"
  ],
  "client_id": "example-client-id"
}

响应

`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"
    }
  ]
}