创建无人认领的草稿

创建可以使用声明 URL 声明的新草稿。第一个访问 URL 的经过身份验证的用户将声明草稿，并将显示加载了草稿的“签名并发送”或“请求签名”页面。后续访问声明 URL 将导致 404。

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

请求

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

请求参数

无 URL、查询或 Header 参数。

Body 参数

UnclaimedDraftCreateRequest必填

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

字段: filesfile_urlsallow_declineattachmentscc_email_addressesclient_idcustom_fieldsfield_optionsform_field_groupsform_field_rulesform_fields_per_documenthide_text_tagsmessagemetadatashow_progress_steppersignerssigning_optionssigning_redirect_urlsubjecttest_modetypeuse_preexisting_fieldsuse_text_tagsexpires_at

{
  "files": [
    {}
  ],
  "file_urls": [
    "https://example.com/resource"
  ],
  "allow_decline": false,
  "attachments": [
    {
      "name": "Example Name",
      "required": false,
      "signer_index": 0
    }
  ],
  "cc_email_addresses": [
    "developer@example.com"
  ],
  "client_id": "example-client-id",
  "custom_fields": [
    {
      "name": "Example Name",
      "required": false
    }
  ],
  "field_options": {
    "date_format": "MM / DD / YYYY"
  }
}

响应

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