Dokki Docs logo

表单

表单将表转换为公共收集端点。提交会向表追加行,因此您可以收集接收请求、注册、反馈、轻量级调查或结构化报告,而无需授予提交者工作区访问权限。

创建表单

打开一个表,然后点击表工具栏中的表单或收集按钮。Dokki 从协作表文档中读取实时表列,并将每个列作为可能的问题开始。

配置问题

  • 设置表单标题和可选描述。

  • 启用或禁用每个列作为问题。

  • 自定义每个问题标签,而无需重命名表列。

  • 当没有值不应接受该行时,将启用的问题标记为必填。

  • 删除的表列将从表单配置中移除;重新打开对话框时,新表列将作为禁用字段追加。

开始并分享收集

保存会存储配置。开始收集会激活一个唯一的匿名表单令牌,并显示 /form/<token> 的分享链接。停止收集会保留配置,但使链接拒绝新的提交。

从另一个系统发送行

在收集对话框中打开 Webhook 面板,以复制私有端点、检查实时字段架构、复制 cURL 示例或轮换令牌。

  • 向 webhook URL 发送 GET 请求,以检索公共字段键、类型、必填标志和允许的选项。

  • 发送带有 Idempotency-Key 标头和形状为 { "values": { "<field-key>": "<value>" } } 的 JSON POST 请求。

  • 端点接受最大 1 MB 的请求体。当配置了 KV 速率限制时,webhook 提交限制为每个 IP 每小时 300 次请求。

将 webhook URL 视为密码。不要将其放在客户端代码或公共文档中。轮换令牌会立即使旧 URL 失效。

提交验证

匿名提交由不可猜测的令牌和表单的活动状态控制。提交时,Dokki 会根据其修改的同一文档中的实时表列定义验证值,因此在添加行之前会检查选择选项和键入的值。

速率限制和错误

当配置了 Vercel KV 速率限制环境变量时,浏览器表单提交限制为每个 IP 每小时 30 次提交。无效值返回字段级验证错误。非活动表单返回错误而不是添加行。

操作说明

  • 一个表单属于一个表资源。

  • 提交计数器是尽力而为的;追加的表行是事实来源。

  • 使用表单进行收集,而不是进行权限编辑。任何拥有活动链接的人都可以提交。

  • 如果您不希望更多匿名行,请在公开共享表之前禁用收集。