플랫폼
웹훅
웹훅은 비동기 작업이 끝났을 때 플랫폼이 내 서버로 보내는 서명된 HTTP 콜백이에요. 덕분에 폴링할 필요가 없어요. 몇 분씩 걸리는 동영상 생성이 대표적인 사례예요.
서명이 있어서 받는 쪽에서 페이로드가 플랫폼에서 온 것인지 검증할 수 있어요.
eroq에서는
Stripe 방식의 eroq-signature 헤더가 붙은 video.generation.succeeded / failed 이벤트를 보내며, 개발자 대시보드에서 설정해요.
자주 묻는 질문
웹훅을 꼭 써야 하나요?
아니요. GET /v1/videos/generations/{id}를 폴링해도 돼요.
eroq는 어떤 이벤트를 보내나요?
video.generation.succeeded와 video.generation.failed, 그리고 대시보드에서 직접 보내 보는 테스트 이벤트가 있어요. 이미지, 음성, 채팅은 요청 자체에 바로 응답하므로 콜백할 일이 없어요.
eroq 웹훅은 어떻게 검증하나요?
서명을 다시 계산하세요. eroq-signature 헤더에는 타임스탬프와 hex 다이제스트가 들어 있어요. 다이제스트는 타임스탬프, 점(.), 원본 본문을 이어 붙인 값에 엔드포인트 시크릿을 키로 HMAC-SHA256을 적용한 값이고, 시크릿은 엔드포인트를 만들 때 한 번만 표시돼요.