跳到内容

文档 · Premium

Webhook 与表格

把 Polls 接入你的工具:每个投票和每次投票都收到事件,或让 Google Sheets 自动拉取结果。

事件

事件发送时机
poll.published发布投票时
poll.closed投票结束时,附带最终结果
vote.cast有人投票时(匿名投票不含用户 ID)
survey.response有人填写问卷时

校验签名

每个请求都是带有 X-Polls-Event、X-Polls-Timestamp 和 X-Polls-Signature 请求头的 JSON POST。用你的签名密钥对 timestamp.body 计算 HMAC-SHA256,并与签名比对。

Google Sheets

  1. 1

    创建链接

    在 表格数据源 下点击 创建数据源链接。

  2. 2

    粘贴公式

    把 =IMPORTDATA("…") 公式复制到单元格。Google Sheets 大约每小时刷新一次。

  3. 3

    保持私密

    拿到链接的人都能看到结果。如果泄露,请使用 新链接。

保存后使用 发送测试,确认你的接口返回 2xx 状态。

常见问题

Webhook 会重试吗?

不会。如果接口连续失败 10 次,发送会暂停 10 分钟。

可以导出单个投票吗?

可以,在控制面板的投票页面导出 CSV 或 JSON。

免费吗?

Webhook、表格数据源和导出属于 Premium。

在你的服务器上试试

Polls 免费。一键添加,一分钟内发出你的第一个投票。