Tally

核心用法

Tally skill 是 Maton 提供的托管 API 网关，通过 gateway.maton.ai 代理访问 Tally 原生 API，自动处理 OAuth 令牌注入。开发者仅需 Maton API Key 即可调用 Tally 的完整功能集，无需自行管理 OAuth 流程。

关键接入路径：

• 网关地址: https://gateway.maton.ai/tally/{endpoint}
• 连接管理: https://ctrl.maton.ai/connections 用于创建/查看/删除 Tally OAuth 连接
• 认证方式: Authorization: Bearer $MATON_API_KEY + User-Agent: Maton/1.0

主要功能模块：
1. 表单管理: 创建/更新/删除表单，支持 17 种区块类型（文本、选择、评分、文件上传、支付、签名等）
2. 提交数据: 分页查询表单提交，支持时间过滤和游标分页
3. 工作空间: 多工作空间管理（Pro 功能）
4. Webhook: 实时接收表单提交事件
5. 成员协作: 组织用户管理和邀请

显著优点

• 零 OAuth 运维: 托管 OAuth 流程，连接状态自动维护
• 全功能覆盖: 覆盖 Tally API 全部核心能力，包括支付字段和签名等高级功能
• 多连接支持: 可通过 Maton-Connection 头切换不同 Tally 账户
• 官方维护: Maton 官方出品，与 Tally 原生 API 保持同步

潜在局限

• 功能限制: 创建工作空间需 Tally Pro 订阅
• 速率限制: 100 请求/分钟，高频场景需配合 Webhook 使用
• Beta 状态: API 仍在公测，可能变更
• UUID 要求: 表单区块需开发者自行生成有效 UUID

适合人群

• 需自动化管理 Tally 表单的企业用户
• 构建客户门户、内部工具的低代码开发者
• 需要将表单数据同步到自有系统的工程师

常规风险

| 风险点 | 说明 |

|--------|------|

| API Key 泄露 | `$MATON_API_KEY` 需妥善保管，具备完整 Tally 访问权限 |

| 误删数据 | DELETE 操作直接移至回收站，但恢复窗口有限 |

| 权限越界 | 连接授权后，Maton 网关可访问该 Tally 账户全部表单数据 |

核心用法

Tally Skill 是 Maton 官方提供的 API 集成工具，通过网关代理方式让用户无需自建 OAuth 即可调用 Tally 完整 API。核心流程包括：获取 Maton API Key → 建立 Tally OAuth 连接 → 通过 gateway.maton.ai/tally 代理端点发起请求。支持表单生命周期管理（创建/发布/归档）、提交数据检索与过滤、工作区协作管理，以及实时 Webhook 推送。

显著优点

1. 零配置 OAuth：自动处理 Tally 的 OAuth 授权流程，无需开发者注册应用或维护令牌刷新。
2. 完整功能覆盖：支持 15+ 种表单字段类型、分页查询、游标分页、日期过滤等高级特性。
3. 多连接管理：通过 Maton-Connection 头支持多账号切换，适合代运营或团队协作场景。
4. 安全合规：所有流量经 HTTPS 加密，API Key 仅通过环境变量读取，无数据驻留风险。

潜在缺点与局限性

1. 平台依赖：完全依赖 Maton 网关可用性，若网关故障则服务中断。
2. 功能限制：创建工作空间需 Tally Pro 订阅，免费版用户受限。
3. 速率限制：100 次/分钟的硬限制，高并发场景需配合 Webhook 替代轮询。
4. Beta 状态：API 仍处于公测阶段，接口可能变更。

适合人群

• 需将 Tally 表单数据同步至内部系统的开发者
• 无代码/低代码平台的集成搭建者
• 代运营多客户 Tally 账号的代理机构
• 希望避免 OAuth 复杂度的中小团队

常规风险

1. 密钥泄露风险：MATON_API_KEY 若泄露，攻击者可访问所有授权连接的数据，需严格保管。
2. Webhook 安全配置：回调 URL 若未验证签名，可能遭受伪造提交攻击。
3. 数据主权问题：数据经 Maton 网关中转，虽加密但需评估合规要求。
4. 授权范围：OAuth 授权后 Maton 可长期访问 Tally 数据，需定期审计活跃连接。