開発者向け
Webhookで回答を自分のサーバーに送る
すべての回答を署名付きのJSONペイロードで受け取り、StrawPollから送られたものか確認します。
最終更新
Webhookは、各回答を自分のサーバー上のアドレスに、JSON本文付きのPOSTリクエストとして送信します。
設定する
- ダッシュボードで連携を開き、連携を追加をクリックしてWebhooksを選びます。
- エンドポイントのURLを入力します。
https://で始まり、インターネットからアクセスできる必要があります。 - 任意: エンドポイントが必要とするヘッダー(例:
Authorizationヘッダー)を追加します。 - 投票を選び、新しい回答、変更された回答、またはその両方を送るかを選んで保存します。
- 連携のページから署名シークレットをコピーし、テストを送信をクリックします。
ペイロード
{
"id": "0193f1c2-…",
"event": "response.created",
"createdAt": "2026-11-08T14:05:12.000Z",
"form": {
"id": "…",
"slug": "team-lunch",
"name": "Team lunch",
"title": "Where should we eat on Friday?",
"url": "https://strawpoll.com/…"
},
"response": {
"id": "…",
"createdAt": "2026-11-08T14:05:11.000Z",
"updatedAt": null,
"deletedAt": null,
"respondent": { "name": "Sam", "email": "sam@example.com", "phone": null },
"answers": [
{
"fieldId": "…",
"question": "Q1 · Where should we eat?",
"value": "…",
"text": "Pizza"
}
],
"comment": null
}
}eventはresponse.created、response.updated、response.deletedのいずれかで、テストを送信の場合はpingです。response.deletedでは、deletedAtに回答者が回答を削除した日時が、answersに送信されていた内容が入ります。自分の記録からも削除してください。idは送信ごとに一意です。すでに処理した送信を無視するために使えます。answersには、すべての質問が順番に並びます。textは結果に表示されるとおりの回答で、valueは生の値です。valueの形式は質問タイプによって異なります。
ヘッダー
| ヘッダー | 内容 |
|---|---|
X-StrawPoll-Event | イベント(例: response.created) |
X-StrawPoll-Delivery | 送信のid |
X-StrawPoll-Timestamp | 送信日時(Unix秒) |
X-StrawPoll-Signature | sha256=と署名 |
署名を検証する
署名は、送信ID、タイムスタンプ、生のリクエスト本文をドットでつないだものに対して、署名シークレットで作成したHMAC-SHA256です。自分で計算して比較します。
import { createHmac, timingSafeEqual } from 'node:crypto';
function isFromStrawPoll(request, rawBody, secret) {
const id = request.headers['x-strawpoll-delivery'];
const timestamp = request.headers['x-strawpoll-timestamp'];
const signature = request.headers['x-strawpoll-signature'] ?? '';
const expected =
'sha256=' + createHmac('sha256', secret).update(`${id}.${timestamp}.${rawBody}`).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
return (
fresh &&
signature.length === expected.length &&
timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
);
}本文はパースする前の、受け取ったままの状態で署名を計算してください。古いタイムスタンプを拒否すれば、傍受したリクエストを第三者が再送する攻撃を防げます。
シークレットが漏れた可能性がある場合は、連携のページで再生成をクリックします。古いシークレットはすぐに使えなくなるので、エンドポイントを更新してください。
時間内に応答する
10秒以内に、2xxのいずれかのステータスで応答してください。時間のかかる処理は、応答したあとに行います。
送信に失敗すると、StrawPollはその後30秒の間に、同じidで3回再送します。429以外の4xxの応答は再送せず、リダイレクトには一切従いません。すべての試行は、サーバーの応答内容とともに最近の送信に表示されます。