SuperAPI AI 工具集

docyrus-webform-design

设计与创作

查看项目

更新于 10-15 21:11

技能介绍

用途:设计、校验并测试 Docyrus 网页表单(webform)。网页表单是公开、免登录的收集入口,提交内容会写入绑定的数据源记录(未绑定时写入按租户隔离的 webform_record 表),并可触发自动化。

主要能力:表单由 tenant_webform 行与一个 webhook 一对一配对;创建时绑定数据源,表单字段 slug 必须与数据源字段 slug 一致,提交才映射到记录列。兼容 Studio/builder 的表单持久化两个 JSON:schema(有序字段与布局)和 options(布局变体、主题、网格/向导、面向填写者的文案)。公开地址使用配对 webhook 的 short id + token,而非表单 UUID。

使用方式:先确认应用与鉴权,并查看目标数据源字段: docyrus auth who --json docyrus apps list --json docyrus studio list-fields --appSlug crm --dataSourceSlug leads --json 然后用 docyrus studio create-webform 创建,必须提供 --name、--schema(非空 JSON 对象)、--status(1 为启用,2 为停用),绑定通过 --dataSourceSlug 或 --dataSourceId。创建后读取 form_url、form_submit_url、embed_code。校验用 get-webform 与 list-webforms,测试时向 form_submit_url POST {"data":{…}},稍后确认记录落入数据源: docyrus ds list crm leads --columns "name, email" --filters '{…}' --json 未绑定表单可用 docyrus curl "/v1/webforms/<webformId>/items" 查看。

限制:绑定仅创建时有效,update-webform 不能改绑数据源,需重建;表单无 slug,只能按 --webformId 读取/更新/删除,删除会级联删除配对 webhook;提交经过队列与 edge function 异步建记录,存在延迟,本地环境该管线可能不执行;空 data POST 视为验证 ping,不存储;更新为 PATCH 部分更新,删除返回 204。

适用场景:需要公开收集线索、报名等外部提交并落入数据源记录,或需在提交时触发自动化的场景。来源未提供的信息(如收费、其他平台支持等)暂未提供。