用途:通过 Dropbox Sign(原 HelloSign)API 完成电子签名流程,包括发送签名请求、跟踪状态、下载已签文件和管理模板。
主要能力:获取账户信息(邮箱、配额、回调地址);发送签名请求,可上传本地 PDF 或提供公开 PDF URL;使用已保存模板发送(send_with_template);查询单个或列表签名请求;取消未完成请求;向指定签署人发送提醒;下载已签 PDF 或 ZIP,或获取短期下载链接;列出与查看模板及签署角色。
使用方式:认证采用 HTTP Basic Auth,API Key 作为用户名、密码为空,curl 中写作 -u "$DROPBOX_SIGN_TOKEN:"(末尾冒号不可省略),不要使用 Bearer。请求体为 multipart/form-data,用 -F 传字段,数组用 signers[0][name] 形式。开发时在所有写请求中加 test_mode=1,测试模式免费且不具法律约束力,正式发送时去掉该字段。可通过轮询 GET /signature_request/{id} 或配置回调 URL(支持 signature_request_signed、signature_request_all_signed 等 webhook)跟踪状态。
适用场景:需要程序化发起合同、NDA 等签署流程,或批量复用模板、集成到自有系统的场景。
限制:资料未提供具体收费与价格信息;get_url=1 返回的签名文件链接有效期很短(通常几分钟),需及时下载或重新生成;模板发送时 signers[Client] 的键名须与模板角色名一致,发送前应先确认角色名;常见状态码包括 awaiting_signature、signed、declined、on_hold、error_unknown。若请求失败,可运行 zero doctor check-connector --env-name DROPBOX_SIGN_TOKEN 或 zero doctor check-connector --url https://api.hellosign.com/v3/account --method GET 排查。