SuperAPI AI 工具集

documenso-hello-world

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:这是一个 Documenso 的最小可用(Hello World)示例技能,适合开始新集成、验证环境配置或学习基础文档签署流程时使用。目标是创建一份开发用文档,添加带签名字段的收件人并发送签署,全部在一个脚本中完成。资料强调应使用合成的占位内容与合成签署人,仅记录环境和不透明的关联/状态,记录一次被脱敏的生命周期回执,并提供清理/停用动作,不留真实签署人、签署链接或生产文档产物。

主要能力:使用 Documenso TypeScript SDK(v2 API)并提供等价的 Python 版本,同时给出 REST API(curl)等价写法。示例覆盖:生成测试 PDF(可选,使用 pdf-lib)、创建文档、上传 PDF、添加收件人(角色 SIGNER)、在指定坐标添加签名字段、发送签署。资料还列出字段类型参考(SIGNATURE、FREE_SIGNATURE、INITIALS、NAME、EMAIL、DATE、TEXT、NUMBER、CHECKBOX、DROPDOWN、RADIO)与文档生命周期(DRAFT→PENDING→COMPLETED,或 REJECTED、CANCELLED)。

使用方式:前置条件为已完成 documenso-install-auth 安装与鉴权设置、DOCUMENSO_API_KEY 环境变量中具备有效 API 密钥、准备一份可上传的 PDF(或按示例生成测试 PDF)。TypeScript 示例用 npx tsx documenso-hello.ts 运行;字段坐标 pageX/pageY 为百分比(0-100)。资料还给出常见错误处理:401 检查 API 密钥、文件过大需压缩或核对套餐限制、字段坐标越界需用 0-100 范围、重复邮箱收件人应更新已有收件人、DRAFT 无法发送通常是缺少收件人或字段。

限制:资料未提供价格、套餐额度、平台支持范围、性能或具体效果数据;PDF 上传上限仅提及需检查计划限制,未给出具体数值。该示例定位为开发/测试用途,不应使用真实协议、真实签署人或生产工作区。