用途:该技能通过托管 OAuth 的网关代理访问 Typeform API,用于在应用中创建与管理表单、检索表单响应及查看洞察数据。
主要能力:用户信息(GET /typeform/me);表单的列出、获取、创建、更新、删除;表单响应的列举与按时间、完成状态过滤;表单洞察摘要;工作区列表与详情。支持字段类型包括 short_text、long_text、email、number、rating、opinion_scale、multiple_choice、yes_no、date、dropdown。
用法:所有请求以 https://gateway.maton.ai/typeform/{endpoint} 为基础地址,并在 Authorization 头中携带 Bearer YOUR_API_KEY(可设为 MATON_API_KEY 环境变量)。例如列出表单:curl -s -X GET 'https://gateway.maton.ai/typeform/forms?page_size=10' -H 'Authorization: Bearer YOUR_API_KEY'。OAuth 连接通过 https://ctrl.maton.ai 管理,可列出、创建、获取和删除连接,创建连接后需在浏览器打开返回的 url 完成授权。
限制与注意:响应分页使用 before token;时间戳为 ISO 8601 格式;DELETE 返回 HTTP 204;限流为每账户每秒 10 次请求;错误码包括 400(缺少 Typeform 连接)、401(API Key 无效或缺失)以及透传的 4xx/5xx。Form ID 为字母数字字符串。未提供的收费、价格或具体使用场景细节暂未提供。