用途:在命令行中以编程方式操作 DocuSign,发送 PDF 供签署、查询信封状态、下载已完成副本,适合服务端自动化流程。
主要能力:send-pdf 发送 PDF 并自动放置签名字段;status 查询信封状态及各签署人状态与签署时间;list 列出近期信封;download 下载合并 PDF(含完成证书);bulk-send 按 JSON 规格批量发送;bulk-download 批量导出指定天数内的信封,生成 manifest.json 支持幂等重跑。
锚点字段:在 PDF 中嵌入占位字符串(默认 [Signature]、[Printed Name]、[Date]),发送时自动在对应位置放置交互字段,无需手动拖拽。可用 --anchor-tabs 覆盖,类型包括 signature、date、fullname、initial、text。
使用方式:先安装依赖 pip install docusign-esign cryptography PyJWT requests;在 DocuSign 管理后台创建 Integration Key 与 RSA 密钥对,保存私钥为 private.key(chmod 600);运行 setup 保存凭据,consent 完成一次性授权,whoami 验证。之后即可调用各命令。支持 --draft、--dry-run 等标志,输出为 JSON。
多账户:通过 DOCUSIGN_PROFILE 环境变量切换凭据文件;V1 仅支持单一模拟用户,多账户需编辑 credentials.json 中的 account_id 切换。
限制:首次配置约需 10 分钟;JWT 访问令牌有效期 1 小时并本地缓存;需一次性浏览器授权;私钥与令牌文件需妥善保管,可在管理后台随时撤销。具体收费与平台支持情况暂未提供。