跳至內容

文件 · 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 免費。一鍵加入,一分鐘內發出你的第一個投票。