재시도
엔드포인트가 15초 안에 2xx 상태로 응답하면 전달이 성공한 것입니다. 그 외(2xx가 아닌 상태, 리디렉션, 시간 초과, 연결 오류, TLS 오류)는 모두 실패로 간주되어 재시도됩니다.
SpacePost는 최대 8번 시도합니다. 첫 시도는 즉시 하고, 이후에는 실패할 때마다 지연 시간을 늘려 재시도합니다.
| 시도 | 이전 실패 후 지연 | 이벤트 후 대략적인 시점 |
|---|---|---|
| 1 | 즉시 | 0 |
| 2 | 5초 | 5초 |
| 3 | 5분 | 5분 |
| 4 | 30분 | 35분 |
| 5 | 2시간 | 2시간 35분 |
| 6 | 5시간 | 7시간 35분 |
| 7 | 10시간 | 17시간 35분 |
| 8 | 10시간 | 27시간 35분 |
8번째 시도마저 실패하면 전달은 failed로 표시되고 더 이상 자동 시도를 하지 않습니다. 직접 재전송할 수 있습니다.
알아 둘 점
섹션 제목: “알아 둘 점”webhook-id는 모든 시도에서 같고 본문도 동일합니다.webhook-timestamp와 서명은 시도마다 다시 생성됩니다.- 전달은 최소 한 번 보장됩니다. 시간 제한 이후에 도착한 느린
2xx는 실패로 처리되므로 엔드포인트가 같은 이벤트를 두 번 받을 수 있습니다.webhook-id로 중복을 제거하세요. - 순서는 보장되지 않습니다. 재시도된
email.delivered가 이후의email.opened보다 늦게 도착할 수 있습니다. 페이로드의created_at을 사용하고 이메일 상태를 뒤로 되돌리지 마세요. - 비활성화되었거나 삭제된 웹훅에는 더 이상 전달하지 않으며, 대기 중이던 전달은 실패로 표시됩니다.
- 최근 시도의 응답 본문(처음 1 KB)과 상태 코드는 대시보드의 전달 로그에서 볼 수 있으며, 로그에는 30일 동안의 기록이 보관됩니다.