무언가 일어났는지 확인하려고 API를 계속 호출하는 방식은 느리고 요청을 낭비합니다. 웹훅은 이를 뒤집습니다. sona.to에 주소를 알려주면, 게시물이 발행되는 순간, 실패하는 순간, 감사가 끝나는 순간에 서명된 HTTP 요청이 도착합니다. Zapier, Make, n8n 또는 직접 운영하는 서버로 향하게 해두면 나머지 스택이 알아서 반응합니다.
발생하는 순간의 이벤트
반응할 가치가 있는 결과를 네 가지 이벤트가 모두 다룹니다. 게시물 발행됨, 게시물 실패, 사이트 감사 완료, 사이트 감사 실패입니다. 각각 API가 반환하는 것과 동일한 필드를 담고 있어 웹훅과 GET의 내용이 일치합니다.
서명되어 있어 신뢰할 수 있습니다
모든 요청에는 타임스탬프와 본문을 대상으로 계산한 HMAC SHA-256 서명이 포함됩니다. 키는 웹훅을 만들 때 한 번만 표시되는 비밀 키입니다. 이를 검증하면 그 요청이 sona.to에서 왔고 재전송된 것이 아님을 알 수 있습니다.
재시도와 전송 기록
전송에 실패하면 60초 후, 이어서 5분 후, 다시 30분 후에 재시도합니다. 모든 시도는 상태 코드와 소요 시간과 함께 기록되므로 문제가 있는 엔드포인트를 쉽게 진단할 수 있습니다.
작동 방식
1
주소 추가
사용 중인 도구가 알려준 주소를 붙여 넣습니다. https여야 합니다.
2
이벤트 선택
해당 엔드포인트가 네 가지 이벤트 중 무엇을 받을지 고릅니다.
3
비밀 키 보관
서명용 비밀 키는 한 번만 표시됩니다. 들어오는 요청을 검증하는 데 쓰이므로 보관해 두세요.
4
자동으로 반응
무언가 일어나는 순간 워크플로가 실행됩니다. 폴링은 필요 없습니다.
누구를 위한 것인가
Zapier, Make, n8n 사용자: 게시물이 나갈 때 워크플로를 실행합니다.
팀: 발행 확인이나 실패를 채팅 채널로 보냅니다.
대행사: 모든 고객 게시물을 자체 리포팅 시스템에 기록합니다.
개발자: 자신의 시스템이 폴링 대신 반응하기를 원합니다.
질문