用途:该技能封装 Ironclad 合同生命周期管理(CLM)API,用于在自动化流程中操作合同工作流、合同记录、审批和 Webhook。当用户提到 Ironclad、合同、合同工作流、CLM 或合同记录时使用。
认证与环境变量:Ironclad 使用静态 API 密钥,以 Bearer token 传递:Authorization: Bearer $IRONCLAD_API_KEY。密钥在 Ironclad 的 Company Settings → API 中生成,且仅作用于单个 Ironclad 实例。需要设置 IRONCLAD_API_KEY 和 IRONCLAD_HOST 两个环境变量。
基础 URL:https://$IRONCLAD_HOST/public/api/v1/。IRONCLAD_HOST 需与实例所在数据区域一致:北美(默认)ironcladapp.com,欧洲 eu1.ironcladapp.com,演示 demo.ironcladapp.com。北美密钥不能用于欧洲主机,反之亦然。
主要能力:工作流方面可列出工作流、获取单个工作流、列出工作流 schema(描述各合同类型的启动表单)、启动工作流、下载工作流文档;记录方面可列出、获取和创建记录;审批方面可列出工作流审批;Webhook 方面可列出和创建 Webhook。
使用方式:所有请求通过 curl 调用上述基础 URL,并附带 Authorization 头。POST 请求体需写入临时 JSON 文件后以 -d @文件 方式提交,且必须带 Content-Type: application/json。列表接口使用 page(从 0 开始)和 pageSize 查询参数分页,响应包含 count 和 list。
故障排查:若请求失败,可运行 zero doctor check-connector --env-name IRONCLAD_API_KEY,或 zero doctor check-connector --url https://$IRONCLAD_HOST/public/api/v1/workflows --method GET。
限制:资料未提供速率限制、错误码、权限范围、Webhook 事件完整列表及价格等信息,暂未提供。