Tally表单API

技能简介

Tally Forms API 提供程序化创建和编辑 Tally.so 表单的能力，支持通过 REST 接口构建调查问卷、反馈表单等各类数据收集工具。

能做什么

• 列出、获取、更新表单及获取提交数据
• 构建多种题型：文本输入、数字、邮箱、日期、电话、长文本
• 实现单选、多选、下拉选择等选项类题目
• 通过替代方案实现评分类题目

使用说明

1. 获取 API 密钥并配置环境变量：TALLY_KEY=$(cat ~/.config/tally/api_key)
2. 调用端点进行表单操作：列表查询 GET /forms、单表获取 GET /forms/{id}、表单更新 PATCH /forms/{id}、提交数据 GET /forms/{id}/submissions
3. 构造表单块结构：每个问题需包含 TITLE 块（题目标签）和输入块，两者共享相同的 groupUuid
4. 选择题需设置 groupType 为 MULTIPLE_CHOICE 或 CHECKBOXES，各选项配置 index、isFirst、isLast 字段
5. 评分题建议使用 MULTIPLE_CHOICE_OPTION 配合星号表情符号实现

输入与输出

见下方输入与输出表格。

风险提示

• RATING 和 LINEAR_SCALE 类型通过 API 创建后无法正常显示，需改用替代方案
• 块结构依赖 groupUuid 正确配对，配置错误会导致表单渲染异常
• API 密钥需妥善保管，避免泄露导致表单数据被篡改

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/yujesyoga/tally/SKILL.md
来源类型：GitHub 仓库