Tally API 技能评估
核心用法
本技能是 Tally 表单平台的 API 网关代理，通过 Maton 托管的 OAuth 服务实现与 Tally API 的安全集成。用户需先在 ctrl.maton.ai 完成 OAuth 授权建立连接，随后即可通过统一的网关地址 gateway.maton.ai/tally 调用原生 Tally API。
主要功能覆盖四大模块：表单管理（创建、更新、发布、删除）、提交数据处理（查询、筛选、导出）、工作空间协作（多成员管理、邀请机制）以及 Webhook 自动化（实时响应表单提交）。API 支持完整的 CRUD 操作，并提供分页机制处理大规模数据。
技术实现上采用网关代理模式——Maton 自动注入 OAuth Token，用户仅需携带 MATON_API_KEY 即可调用，大幅降低第三方 OAuth 的接入复杂度。
显著优点
1. 托管 OAuth 简化集成：无需自行处理 Tally 的 OAuth 流程，连接生命周期由 Maton 管理
2. 功能覆盖面广：完整支持表单构建、支付字段、文件上传、签名等 15+ 种区块类型
3. 实时数据能力：Webhook 机制支持 FORM_RESPONSE 事件，避免轮询消耗
4. 多连接管理：支持多 Tally 账户切换，通过 Maton-Connection 头部指定
5. 文档完备：提供 cURL、Python、JavaScript 多语言示例，错误码与排错指南清晰
潜在局限与风险
| 方面 | 说明 |
|------|------|
| **功能依赖** | 创建工作空间需 Tally Pro 订阅，免费用户受限 |
| **Beta 状态** | API 明确标注 public beta，接口可能变更 |
| **速率限制** | 100 请求/分钟，高频场景需配合 Webhook |
| **网关依赖** | 所有流量经 Maton 网关，单点故障风险 |
| **Token 管理** | OAuth Token 由 Maton 托管，用户无直接控制权 |
适合人群
- 需要自动化表单数据处理的产品运营、市场团队
- 构建客户反馈系统的开发者
- 希望将 Tally 与内部系统集成的技术团队
- 低代码/无代码工作流搭建者
常规风险
1. 凭证安全：MATON_API_KEY 需妥善保管，避免硬编码提交至版本控制
2. 数据隐私：表单提交内容经 Maton 网关传输，需评估合规性要求
3. 服务连续性：Tally 或 Maton 任一方服务中断将影响功能可用性
4. 授权范围：OAuth 授权后，Maton 可访问完整 Tally 账户数据，需信任第三方平台