웹훅 및 이벤트 전달

이벤트 식별자

시스템이 재전송을 인식하고 처리 이력을 찾는 데 사용하는 고유 값.

이벤트 유형

발생한 변경과 처리 방법을 정의하는 명확하고 안정적인 이름.

생성 시간

합의된 형식과 시간대의 이벤트 생성 날짜 및 시간.

관련 객체

결제, 플레이어, 라운드, 요청, 보너스 또는 기타 객체의 유형과 식별자.

스키마 버전

버전 번호는 활성 통합을 중단하지 않고 메시지 구조를 안전하게 변경하는 데 도움을 줍니다.

처리 연계

원본 요청, 거래, 세션 또는 관련 작업 체인의 식별자.

컨텍스트

올바른 라우팅에 필요한 브랜드, 프로젝트, 시장, 환경, 제공업체 및 기타 데이터.

이벤트 데이터

변경을 처리하거나 이후 API 요청을 수행하는 데 필요한 최소 필드 집합.

성공 HTTP 응답

이벤트가 검증되고 후속 처리를 위해 안정적으로 저장되었음을 확인합니다.

제한된 타임아웃

발신자에게 응답하기 전에 오래 걸리는 처리를 하지 말고 먼저 이벤트를 저장합니다.

재전송

일시적 네트워크 오류, 이용 불가 또는 응답 없음 이후 전달을 다시 시도합니다.

재시도 간격 증가

추가 부하를 만들지 않도록 시도 간 대기 시간을 점진적으로 늘립니다.

미전달 이벤트 큐

모든 시도를 소진한 후 이벤트를 진단 및 수동 처리를 위해 보관합니다.

수동 재전송

운영 담당자는 새 처리를 생성하지 않고 선택한 이벤트를 다시 전송할 수 있습니다.

전달 모니터링

시도 횟수, 응답, 최근 오류 및 다음 전달 시간을 추적합니다.

알림

오류가 증가하거나 재시도가 소진되거나 이벤트가 큐에 누적되면 팀에 알립니다.

변조된 메시지, 알 수 없는 키, 만료된 타임스탬프 및 지원되지 않는 알고리즘.

같은 이벤트가 처리 완료 전후에 여러 번 도착합니다.

수신자의 응답이 너무 늦거나 연결이 끊기거나 수신 확인이 발신자에게 도달하지 않습니다.

최종 상태가 중간 상태보다 먼저 도착하고 오래된 이벤트가 새로운 이벤트 이후에 전달됩니다.

HTTP 5xx 오류, DNS, TLS, 요청 빈도 제한 및 재시도 완전 소진을 테스트합니다.

모든 시도, 응답, 오류 및 수동 재전송 결과를 이벤트 식별자로 검색할 수 있어야 합니다.