SuperAPI AI 工具集

typeform

编程与开发

查看项目

更新于 10-16 09:47

技能介绍

用途:通过 Typeform 官方 API 管理表单、回答数据、Webhook,以及工作区与主题等资源,适合需要程序化创建问卷、批量读取提交结果或将新回答推送到自有服务的场景。

主要能力:表单的列表、检索、创建、整体替换更新、JSON Patch 局部更新与删除,读取表单校验提示文案;回答的列表查询(支持 page_size、since/until、after/before 游标、response_type、query 检索、fields 与 sort)、按 ID 删除、下载文件上传内容;Webhook 的列表、按自定义 tag 创建或替换、单个检索与删除;工作区列表与创建;主题列表与检索;账户信息(/me)。

使用方式:所有请求需 Bearer 令牌,令牌格式为 tfp_ 开头的 40 位十六进制。基地址为 https://api.typeform.com,欧盟数据驻留账户改用 https://api.eu.typeform.com。令牌置于环境变量 TYPEFORM_TOKEN。请求失败时可用 zero doctor check-connector --env-name TYPEFORM_TOKEN 或 zero doctor check-connector --url https://api.typeform.com/forms --method GET 排查。表单字段的 type 可选 short_text、long_text、email、phone_number、website、number、multiple_choice、dropdown、picture_choice、yes_no、legal、rating、opinion_scale、nps、date、file_upload、payment、matrix、ranking,以及 statement、group、welcome_screen、thankyou_screen 等布局类型。

限制:Create 与 Responses API 限速约每秒 2 次请求,超限返回 429;令牌按已授予的 scope 生效(forms、responses、webhooks、workspaces、themes、accounts 的读写),403 通常意味着 scope 不足。回答数据超过约 1000 条时建议使用游标分页。创建 Webhook 时传入 secret,接收端需校验 Typeform-Signature 头。表单更新使用整体替换或 JSON Patch,删除返回 204。具体费用、套餐与配额规则暂未提供。