개발자
웹훅으로 내 서버에 응답 보내기
모든 응답을 서명된 JSON 페이로드로 받고, StrawPoll에서 보낸 것인지 확인하세요.
최종 업데이트
웹훅은 각 응답을 내 서버의 주소로 JSON 본문이 담긴 POST 요청으로 보냅니다.
설정하기
- 대시보드에서 연동을 열고 연동 추가를 클릭한 다음 웹훅을 선택하세요.
- 엔드포인트 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는 원시 값으로 질문 유형에 따라 형태가 다릅니다.
헤더
| 헤더 | 내용 |
|---|---|
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은 같은 id로 이후 30초 동안 세 번 재시도합니다. 429를 제외한 4xx 응답은 재시도하지 않으며, 리디렉션은 절대 따라가지 않습니다. 모든 시도는 서버의 응답 내용과 함께 최근 전송에 표시됩니다.