零维护 OAuth 的表单数据中枢

通过 Maton 代理服务管理 Tally 表单、提交数据和工作空间，支持 OAuth 托管与 webhook 集成，需 MATON_API_KEY。

基本信息

• 技能名称?Tally
• 中文名称?零维护 OAuth 的表单数据中枢
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.3
• 标签?form-builder, data-collection, webhook, oauth, api-proxy, automation, no-code-integration

使用方法

使用说明
核心用法
Tally Skill 是 Maton 平台提供的 Tally 表单 API 代理服务，采用托管式 OAuth 认证，无需用户自行处理令牌刷新。用户通过 MATON_API_KEY 调用 https://api.maton.ai/tally/ 端点，可完成表单全生命周期管理（创建/更新/删除/发布）、提交数据查询与导出、工作空间协作及 webhook 配置。支持 Python、JavaScript 等多语言调用，表单构建采用 JSON Block 结构，涵盖文本输入、选择题、文件上传、支付等 15+ 字段类型。
显著优点
零 OAuth 维护成本 ：Maton 自动注入并刷新 Tally 令牌，用户仅需管理单一 API Key
完整表单生态覆盖 ：支持表单设计、发布状态管理、提交数据分页导出（含日期过滤）、实时 webhook 推送
多租户隔离 ：通过 Maton-Connection 头可切换多个 Tally 账户，适合代运营或团队场景
标准化错误体系 ：HTTP 状态码清晰区分认证失败（401）、权限不足（403）、速率限制（429）等问题
潜在局限
订阅门槛 ：创建工作空间需 Tally Pro 订阅，免费用户受限
速率限制 ：100 请求/分钟，高频场景需配合 webhook 而非轮询
Beta 稳定性 ：API 标注为公开测试版，接口契约可能变更
代理依赖 ：所有请求需经过 Maton 网关，形成额外单点故障风险
写入需确认 ：文档要求对创建/更新/删除操作显式用户确认，自动化流程需额外交互设计
适合人群
需将 Tally 表单数据集成至内部系统的开发者
代运营多个 Tally 客户账户的代理机构
追求低代码 OAuth 方案、不愿维护令牌刷新逻辑的中小团队
常规风险
密钥泄露 ： MATON_API_KEY 泄露将导致所有托管 Tally 账户被滥用，需严格环境变量隔离
数据残留 ：删除操作仅移至回收站，敏感数据需额外确认彻底清除
Webhook 投递失败 ：未配置重试机制或端点不可用时可能丢失实时事件